Experimental/brain-of-reese
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

phase: 168_admin_settings_panel
Build and Push Containers / build-and-push-app (push) Successful in 4m4s
Details
Build and Push Containers / build-and-push-db (push) Successful in 15s
Details

Browse Source 
**Phase 168 — Admin Settings panel — final verification: PASS**

1. **Implemented/verified:** `/settings.html` (admin-only) with the 75-field catalogue (`app/core/settings_catalog.py`), DB-over-env overrides in Postgres (`app_settings`, migration 0028 at head, `settings_overlay.py` resolver, `app/api/admin_settings.py` — 4 admin-only routes), live-apply on save with no restart + restart-required badges, Reset/Clear all, write-only secrets, `.env`-never-written, `BOR_SETTINGS_DB=0` kill switch.
2. **Phase E2E: 12/12** — run with `E2E_APP_PORT=8200` (ports 8123/8124 are held by an unrelated "undercooked" project; no process killed, no code change — the documented env override).
3. **Regression set: all 7 suites green in isolation** (theme tab, API tokens, configurable brand, global tuning, admin auth, cache busting, wide desktop column — 38 tests).
4. **Full suite: unit+integration exit 0 (4066 passed), app/ coverage 99%** (gate >90%); **ruff clean, pyright 0 errors / 0 warnings.**
5. **Log contract (rule 10) verified live:** per-turn + per-response byte-budget lines present; settings write lines carry key + action, **never the value**.
6. **Byte-budget audit: all endpoints under the 262,144 B budget**; settings catalogue 23,513 B (gzip 3,326).
7. **Defect fixed (one):** criterion 5 had no integration pin — added `test_bad_row_inserted_directly_never_bricks_boot` to `tests/integration/test_admin_settings_api.py` (malformed row inserted directly → fresh `create_app()` boots, row skipped with logged reason, rest of table applies, `/api/health` 200) — 12/12 green.
8. **Docs pass:** `README.md` and `AGENTS.md` reviewed in full — both consistent with the as-built feature (Settings page table, Settings section, Configuration-reference note, `.env.example` block); **no changes required**.
9. **Cleanup:** audit app killed (by PID); `app_settings` left empty (0 rows); all changes left in the working tree (no commit, per protocol).
10. **Completion criteria:** all 7 checkboxes verified green (criterion 7's commit is the harness's).
11. **Next pending phase:** `170_edit_bubble_sizing`.
This commit is contained in:
ducoterra
2026-10-10 01:05:14 -04:00
parent abe7388dda
commit 1200437bf8
79 changed files with 7148 additions and 378 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__00_phase.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__00_phase.a1.md
+13
View File
@@ -0,0 +1,13 @@
**Phase 168 — Admin Settings panel — final verification: PASS**
1. **Implemented/verified:** `/settings.html` (admin-only) with the 75-field catalogue (`app/core/settings_catalog.py`), DB-over-env overrides in Postgres (`app_settings`, migration 0028 at head, `settings_overlay.py` resolver, `app/api/admin_settings.py` — 4 admin-only routes), live-apply on save with no restart + restart-required badges, Reset/Clear all, write-only secrets, `.env`-never-written, `BOR_SETTINGS_DB=0` kill switch.
2. **Phase E2E: 12/12** — run with `E2E_APP_PORT=8200` (ports 8123/8124 are held by an unrelated "undercooked" project; no process killed, no code change — the documented env override).
3. **Regression set: all 7 suites green in isolation** (theme tab, API tokens, configurable brand, global tuning, admin auth, cache busting, wide desktop column — 38 tests).
4. **Full suite: unit+integration exit 0 (4066 passed), app/ coverage 99%** (gate >90%); **ruff clean, pyright 0 errors / 0 warnings.**
5. **Log contract (rule 10) verified live:** per-turn + per-response byte-budget lines present; settings write lines carry key + action, **never the value**.
6. **Byte-budget audit: all endpoints under the 262,144 B budget**; settings catalogue 23,513 B (gzip 3,326).
7. **Defect fixed (one):** criterion 5 had no integration pin — added `test_bad_row_inserted_directly_never_bricks_boot` to `tests/integration/test_admin_settings_api.py` (malformed row inserted directly → fresh `create_app()` boots, row skipped with logged reason, rest of table applies, `/api/health` 200) — 12/12 green.
8. **Docs pass:** `README.md` and `AGENTS.md` reviewed in full — both consistent with the as-built feature (Settings page table, Settings section, Configuration-reference note, `.env.example` block); **no changes required**.
9. **Cleanup:** audit app killed (by PID); `app_settings` left empty (0 rows); all changes left in the working tree (no commit, per protocol).
10. **Completion criteria:** all 7 checkboxes verified green (criterion 7's commit is the harness's).
11. **Next pending phase:** `170_edit_bubble_sizing`.
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__00_phase.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__00_phase.a1.validate
+134
View File
@@ -0,0 +1,134 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 15%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 24%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 31%]
........................................................................ [ 33%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 38%]
........................................................................ [ 40%]
........................................................................ [ 42%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 47%]
........................................................................ [ 49%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 54%]
........................................................................ [ 56%]
........................................................................ [ 58%]
........................................................................ [ 60%]
........................................................................ [ 61%]
........................................................................ [ 63%]
........................................................................ [ 65%]
........................................................................ [ 67%]
........................................................................ [ 69%]
........................................................................ [ 70%]
........................................................................ [ 72%]
........................................................................ [ 74%]
........................................................................ [ 76%]
........................................................................ [ 77%]
........................................................................ [ 79%]
........................................................................ [ 81%]
........................................................................ [ 83%]
........................................................................ [ 84%]
........................................................................ [ 86%]
........................................................................ [ 88%]
........................................................................ [ 90%]
........................................................................ [ 92%]
........................................................................ [ 93%]
........................................................................ [ 95%]
........................................................................ [ 97%]
........................................................................ [ 99%]
.................................. [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/admin_settings.py 108 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 280 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 86 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 532 0 100%
--------------------------------------------------
TOTAL 6392 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__01_app_settings_table.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__01_app_settings_table.a1.md
+19
View File
@@ -0,0 +1,19 @@
Task 01 complete. Report:
**Implemented**
- `app/models.py`: `AppSetting` model appended after `FolderSummary` — `key` (bare field name, VARCHAR(100) PK), `value` (env-native string, TEXT NOT NULL), `updated_at` (TIMESTAMPTZ, server `now()`); module docstring table list updated. `func` was already imported — no new imports.
- `alembic/versions/0028_app_settings.py` (revision 0028 ← 0027): `create_table` upgrade, `drop_table` downgrade with the A13 comment (0027-style docstring).
- `tests/integration/test_migration_0028.py`: 0017-harness, 6 tests — column/PK contract, 0027 schema survives, value round-trips, duplicate-key `IntegrityError`, NULL-value rejection, A13 downgrade/round-trip.
- `.env.example`: top comment block — DB-over-env precedence, panel never writes the file, `BOR_SETTINGS_DB=0` kill switch in container env (not committed here).
**Gates**
- `uv run alembic upgrade head` → 0028 applied; `downgrade 0027` → table gone; re-upgrade clean
- `uv run pytest tests/integration/test_migration_0028.py -v` → 6 passed
- `uv run pytest --cov=app` (3,986 tests) → exit 0, 100% green; `app/` coverage **99%** (>90%)
- `uv run ruff check .` → all passed; `uv run pyright` → 0 errors
**Docs** — `.env.example` updated (per task); no README/AGENTS.md impact (no API/CLI/user-visible change yet — the API note lands in task 04). No behavior change: nothing reads `app_settings` yet (task 02).
**Decisions** — migration create date 2026-10-09 (phase date); module-docstring bullet added alongside the class for house consistency.
**Next pending task** — `02_settings_overlay_resolver.md`
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__01_app_settings_table.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__01_app_settings_table.a1.validate
+130
View File
@@ -0,0 +1,130 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 9%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 16%]
........................................................................ [ 18%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 25%]
........................................................................ [ 27%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 32%]
........................................................................ [ 34%]
........................................................................ [ 36%]
........................................................................ [ 37%]
........................................................................ [ 39%]
........................................................................ [ 41%]
........................................................................ [ 43%]
........................................................................ [ 45%]
........................................................................ [ 46%]
........................................................................ [ 48%]
........................................................................ [ 50%]
........................................................................ [ 52%]
........................................................................ [ 54%]
........................................................................ [ 55%]
........................................................................ [ 57%]
........................................................................ [ 59%]
........................................................................ [ 61%]
........................................................................ [ 63%]
........................................................................ [ 65%]
........................................................................ [ 66%]
........................................................................ [ 68%]
........................................................................ [ 70%]
........................................................................ [ 72%]
........................................................................ [ 74%]
........................................................................ [ 75%]
........................................................................ [ 77%]
........................................................................ [ 79%]
........................................................................ [ 81%]
........................................................................ [ 83%]
........................................................................ [ 84%]
........................................................................ [ 86%]
........................................................................ [ 88%]
........................................................................ [ 90%]
........................................................................ [ 92%]
........................................................................ [ 93%]
........................................................................ [ 95%]
........................................................................ [ 97%]
........................................................................ [ 99%]
.......................... [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 277 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 280 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 73 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 505 0 100%
--------------------------------------------------
TOTAL 6107 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__02_settings_overlay_resolver.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__02_settings_overlay_resolver.a1.md
+19
View File
@@ -0,0 +1,19 @@
All green. Task 02 complete.
## Report
**Implemented (phase 168, task 02):**
- `app/core/settings_catalog.py` — `SettingMeta` + complete 75-field `CATALOG` (14 groups in the prescribed display order), `GROUPS`, derived `SECRETS`/`RESTART_REQUIRED`/`NON_OVERRIDABLE`, `env_var()`
- `app/core/settings_overlay.py` — `resolve_settings()` (env base + kill switch + DB rows, never calls back into config), `enabled()` per-call `BOR_SETTINGS_DB` read, `load_overrides()` (lazy `NullPool` engine, fail-soft: DEBUG once per process for missing table, WARNING once naming the exception class), `merge()` (per-key skip: orphan/non-overridable/malformed-JSON/validator-drop with cross-field + env-collision fallback, each logged `settings override ignored key=… reason=…`), `register_invalidator`/`run_invalidators` (raising hook logged, never propagated), `reset_state_for_tests()`
- `app/config.py` — `get_settings()` → cached lazy delegate to the overlay (`@lru_cache` + `cache_clear()` surface intact), new `invalidate_settings()`
- `app/main.py` — post-`ensure_admin_configured` prime: `invalidate_settings()` + `get_settings()` + one boot line (`settings overrides loaded count=N` / `source=env-only disabled`)
- Poison guards: `tests/conftest.py` (`setdefault BOR_SETTINGS_DB=0`), `tests/e2e/conftest.py` (hard pin beside `BOR_PDF_PICTORIAL`)
- Unit pins: `test_settings_catalog.py` (completeness both directions, closed groups, exact SECRET/NON_OVERRIDABLE/RESTART sets, label/`env_var` pins) + `test_settings_overlay.py` (enabled matrix, `_coerce`, merge happy/skip/invalid/cross-field/env-collision/bool, load failure paths, invalidator registry, recursion-guard + no-`.env`-write source pins)
**Gates:** `uv run pytest` → 4017 passed (run twice — empty `app_settings` and with garbage rows, both green: poison guard proven) · `--cov=app` → 99% (>90%; both new modules 100%) · `ruff check .` clean · `pyright` 0 errors · live-DB checks: DB row wins on / env wins with `BOR_SETTINGS_DB=0` / `database_url`+`embedding_dim` rows skipped+logged · boot log verified both variants
**Docs:** README Configuration reference — added the DB-over-env precedence paragraph + `BOR_SETTINGS_DB` switch (`.env.example` block landed in task 01). AGENTS.md: no doc impact (it documents no env vars).
**Decisions:** standalone `BOR_RELEVANCE_THRESHOLD=0.11` raises the pre-existing cross-field validator (floor 0.35 > 0.11) — verified `Settings()` pre-phase raises identically; with consistent floors it prints 0.11. The validator-blames-env-field case (env floor above a DB threshold) resolves by dropping the colliding override row, not the env value — terminates, rest of the table stands (A5).
**Next pending task:** `03_live_apply_on_save.md`
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__02_settings_overlay_resolver.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__02_settings_overlay_resolver.a1.validate
+132
View File
@@ -0,0 +1,132 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 16%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 25%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 32%]
........................................................................ [ 34%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 39%]
........................................................................ [ 41%]
........................................................................ [ 43%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 48%]
........................................................................ [ 50%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 55%]
........................................................................ [ 57%]
........................................................................ [ 59%]
........................................................................ [ 60%]
........................................................................ [ 62%]
........................................................................ [ 64%]
........................................................................ [ 66%]
........................................................................ [ 68%]
........................................................................ [ 69%]
........................................................................ [ 71%]
........................................................................ [ 73%]
........................................................................ [ 75%]
........................................................................ [ 77%]
........................................................................ [ 78%]
........................................................................ [ 80%]
........................................................................ [ 82%]
........................................................................ [ 84%]
........................................................................ [ 86%]
........................................................................ [ 87%]
........................................................................ [ 89%]
........................................................................ [ 91%]
........................................................................ [ 93%]
........................................................................ [ 94%]
........................................................................ [ 96%]
........................................................................ [ 98%]
......................................................... [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 277 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 81 2 98%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 505 0 100%
--------------------------------------------------
TOTAL 6249 19 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__03_live_apply_on_save.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__03_live_apply_on_save.a1.md
+18
View File
@@ -0,0 +1,18 @@
All gates green. Task complete.
## Report
**Implemented (phase 168, task 03 — live apply on Save):**
- `app/api/chat.py`: `reset_runtime_caches()` below `get_llm()` — nulls the `_llm` / `_chat_semaphore` settings snapshots (in-flight-turn contract in the docstring; `_chat_active` untouched)
- `app/main.py`: `create_app()` registers `register_invalidator(reset_runtime_caches)` right after the task-02 prime line, with a one-time `settings invalidator registered name=chat_runtime_caches` log line (composition root — `app/core/` stays import-clean of `app/api/`)
- `tests/unit/test_settings_live_apply.py` (9 tests): null/reset pins, `get_llm()` singleton + rebuild, semaphore follows `BOR_CHAT_MAX_CONCURRENT`, the `create_app` wiring source pin, `app/core`→no-`app/api` grep pin, `invalidate_settings()` hook-run + cache-clear proof, raising-hook survival
- `tests/integration/test_admin_settings_live.py` (6 tests, `db`-fixture skip idiom): `relevance_threshold` flip proven through `plan_turn` (HIGH→LOW, no restart), `LLMClient` rebuild (`llm_chat_model` + `llm_timeout` → `AsyncOpenAI` base_url + connect timeout), semaphore cap re-pointing, kill-switch→env-back, `import_extension_set` overlay reach; teardown leaves the table empty (verified: 0 rows)
- `tests/unit/test_main.py`: added the switch-ON boot-prime test (closes the 2 previously-uncovered `app/main.py` lines — a task-02 gap)
**Results:** `uv run pytest` → 4033 passed, 0 failed · `uv run pytest --cov=app --cov-report=term-missing` → 99% TOTAL (>90% gate; `app/main.py` 100%, `settings_overlay.py` 100%) · `uv run ruff check .` → all passed · `uv run pyright` → 0 errors · chat pins (`test_chat_*`, `test_chat_api.py`, `test_chat_concurrency.py`) pass untouched · integration suite green (teardown leaves nothing behind)
**Docs:** `.env.example` — added the "restart required" sentence to the phase-168 comment block (per task step 5); `README.md` — matching one-sentence supplement to the phase-168 paragraph; no `AGENTS.md` impact (no command/convention change)
**Decisions:** openai normalizes `base_url` with a trailing slash — the pin compares against `rstrip("/") + "/"`; `AsyncOpenAI._client` is a wrapper (`.timeout` still delegates to httpx, `connect == 7.0` asserted); the integration fixture re-wires the reset hook after `reset_state_for_tests()` since a prior unit suite's reset would have cleared the `app.main`-import registration
**Next pending task:** `04_admin_settings_api.md`
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__03_live_apply_on_save.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__03_live_apply_on_save.a1.validate
+133
View File
@@ -0,0 +1,133 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 16%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 24%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 32%]
........................................................................ [ 33%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 39%]
........................................................................ [ 41%]
........................................................................ [ 42%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 48%]
........................................................................ [ 49%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 55%]
........................................................................ [ 57%]
........................................................................ [ 58%]
........................................................................ [ 60%]
........................................................................ [ 62%]
........................................................................ [ 64%]
........................................................................ [ 66%]
........................................................................ [ 67%]
........................................................................ [ 69%]
........................................................................ [ 71%]
........................................................................ [ 73%]
........................................................................ [ 74%]
........................................................................ [ 76%]
........................................................................ [ 78%]
........................................................................ [ 80%]
........................................................................ [ 82%]
........................................................................ [ 83%]
........................................................................ [ 85%]
........................................................................ [ 87%]
........................................................................ [ 89%]
........................................................................ [ 91%]
........................................................................ [ 92%]
........................................................................ [ 94%]
........................................................................ [ 96%]
........................................................................ [ 98%]
........................................................................ [ 99%]
. [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 280 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 84 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 505 0 100%
--------------------------------------------------
TOTAL 6255 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__04_admin_settings_api.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__04_admin_settings_api.a1.md
+18
View File
@@ -0,0 +1,18 @@
All green. Final report:
**Implemented (task 04 — `/api/admin/settings`):**
- `app/schemas.py`: `AdminSettingItem` / `AdminSettingsTotals` / `AdminSettingsOut` / `AdminSettingIn` / `AdminSettingsCleared` (phase-168 docstring style)
- `app/api/admin_settings.py`: router-wide `require_admin` (anon + token user 403); GET catalogue in `GROUPS` order with `db`/`env`/`default` badges + `overlay_enabled`; PUT with 404/422 guards (A3 keys, blank secret) + full-candidate validation through the overlay's `_coerce` + real `Settings` validators (422 names the field, nothing written); `pg_insert` upsert; `DELETE /{key}` idempotent reset; `DELETE ""` clear-all; value-free log lines; `invalidate_settings()` on every write
- `app/main.py`: router included after `ui_settings_router` with the house comment
- Tests: `tests/integration/test_admin_settings_api.py` (11 tests: auth matrix, shape/order, write→live via `get_settings()` + `/api/config`, 404/422/invalid-JSON/cross-field, masking (raw-text assert), reset/clear-all, kill switch, <64 KB budget, caplog log pin) + `tests/unit/test_admin_settings_api.py` (8 tests: `_display`/`_field_type`, masked/default/db branches, `.env`-never-written + no-shell static pins)
**Results (all 100% green):**
- `uv run pytest --cov=app` → 4052 passed, app/ coverage 99% (>90% gate); `app/api/admin_settings.py` 100%
- `uv run pytest tests/integration/test_admin_settings_api.py -v` → 11 passed; integration suite run 3× incl. once with a deliberate poison `app_settings` row — teardown left 0 rows
- `uv run ruff check .` clean; `uv run pyright` clean (5 initial errors fixed: Literal annotation, `RETURNING` instead of `rowcount`)
**Docs:** README Configuration reference — made the precedence explicit (`app_settings` row → `BOR_*` env → code default) + documented the `/api/admin/settings` routes & write-only secrets; `.env.example` already complete from tasks 01/03; no AGENTS.md impact (it documents operating rules, not endpoints)
**Decisions:** `source="db"` requires the overlay switch ON (kill switch off → badge falls back to env/default, `overlay_enabled=false` banner); unknown DELETE key → 404 like PUT (idempotency is row-absent only); `totals.overridden` counts in-effect rows
**Next pending task:** `.agents/phases/todo/168_admin_settings_panel/05_settings_view_ui.md`
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__04_admin_settings_api.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__04_admin_settings_api.a1.validate
+134
View File
@@ -0,0 +1,134 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 15%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 24%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 31%]
........................................................................ [ 33%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 39%]
........................................................................ [ 40%]
........................................................................ [ 42%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 47%]
........................................................................ [ 49%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 55%]
........................................................................ [ 56%]
........................................................................ [ 58%]
........................................................................ [ 60%]
........................................................................ [ 62%]
........................................................................ [ 63%]
........................................................................ [ 65%]
........................................................................ [ 67%]
........................................................................ [ 69%]
........................................................................ [ 71%]
........................................................................ [ 72%]
........................................................................ [ 74%]
........................................................................ [ 76%]
........................................................................ [ 78%]
........................................................................ [ 79%]
........................................................................ [ 81%]
........................................................................ [ 83%]
........................................................................ [ 85%]
........................................................................ [ 87%]
........................................................................ [ 88%]
........................................................................ [ 90%]
........................................................................ [ 92%]
........................................................................ [ 94%]
........................................................................ [ 95%]
........................................................................ [ 97%]
........................................................................ [ 99%]
.................... [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/admin_settings.py 108 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 280 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 86 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 532 0 100%
--------------------------------------------------
TOTAL 6392 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__05_settings_view_ui.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__05_settings_view_ui.a1.md
+14
View File
@@ -0,0 +1,14 @@
All green. Final report:
**Phase 168 task 05 (Settings view) — complete** (work was largely present in the working tree from a prior partial run; I verified every item, fixed two defects, and re-verified end-to-end)
- `#view-settings` in `index.html` (72rem container, gate, kill-switch banner, status/alert regions, search, `.table-wrap` catalogue, Save/Clear-all/dirty-hint action row) + `#nav-settings` (ship-hidden) on all 4 Theme-bearing pages
- `router.js` (VIEW/VIEW_PATH/VIEW_MODULES + title/description), `main.py` shell route, `caching.HTML_PAGES`, `header.js` admin-keyed reveal
- `settings.js` (gate-first, createElement/textContent only, dirty Map, K4 stop-at-first-failure, two-step confirm, client-side filter) + `styles.css` phase-168 block (no new `:root` tokens) + `test_settings_frontend_view.py` (13 pins)
- **Fixes:** ruff W291 trailing-whitespace and pyright `None.group()` access in `test_settings_frontend_view.py`
- Verified live: `/settings.html` 200 + `no-cache` + `?v=` rewrite; anon API 403; admin GET → 75 items, 4 masked secrets, zero plaintext; PUT `input_placeholder` → `GET /api/config` shows the override **without restart**; value-free `settings action=…` log line; DELETE → env/default wins
- `uv run pytest --cov=app`: **4065 passed, 99% coverage** (>90%); `uv run ruff check .`: clean; `uv run pyright`: 0 errors
- Docs: README updated (Settings page section + DB-over-env env note); AGENTS.md — no doc impact (no page inventory; rules are generic)
- No live-infra changes (dev-container DB only)
**Next pending task:** `168_admin_settings_panel/06_e2e_settings_panel.md` (the phase's Playwright suite + regression set + atomic commit)
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__05_settings_view_ui.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__05_settings_view_ui.a1.validate
+134
View File
@@ -0,0 +1,134 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 15%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 24%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 31%]
........................................................................ [ 33%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 38%]
........................................................................ [ 40%]
........................................................................ [ 42%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 47%]
........................................................................ [ 49%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 54%]
........................................................................ [ 56%]
........................................................................ [ 58%]
........................................................................ [ 60%]
........................................................................ [ 61%]
........................................................................ [ 63%]
........................................................................ [ 65%]
........................................................................ [ 67%]
........................................................................ [ 69%]
........................................................................ [ 70%]
........................................................................ [ 72%]
........................................................................ [ 74%]
........................................................................ [ 76%]
........................................................................ [ 77%]
........................................................................ [ 79%]
........................................................................ [ 81%]
........................................................................ [ 83%]
........................................................................ [ 85%]
........................................................................ [ 86%]
........................................................................ [ 88%]
........................................................................ [ 90%]
........................................................................ [ 92%]
........................................................................ [ 93%]
........................................................................ [ 95%]
........................................................................ [ 97%]
........................................................................ [ 99%]
................................. [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/admin_settings.py 108 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 280 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 86 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 532 0 100%
--------------------------------------------------
TOTAL 6392 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__06_e2e_settings_panel.a1.err
View File
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__06_e2e_settings_panel.a1.md
+12
View File
@@ -0,0 +1,12 @@
All gates green and the working tree is exactly my three changes (plus prior-task artifacts the harness owns). Final report:
**Phase 168 · Task 06 — E2E for the Admin Settings panel: COMPLETE**
1. **New suite** `tests/e2e/test_admin_settings_panel.py` — **12/12 pass in isolation** (`uv run pytest tests/e2e/test_admin_settings_panel.py -v --no-cov`, Postgres up).
2. **Contract proven in a real browser**: admin saves a `.env`-only setting (75 `BOR_*` fields, `app_settings`) → **the same running app serves the new value on the next real chat turn — no restart, no `.env` write** (`.env` mtime guarded); the gate (anon 403 + no data leak, token users never see the panel), 422 refusal with the alert, the K4 failed-batch error fix (a real `settings.js` defect — the failed save's re-`GET` was clearing its own error — now fixed: re-GET first, *then* the error), Reset, Clear All, the kill-switch banner, secret rows masked, source badges, and a full keyboard walk (skip-link → … → first row control).
3. **Live-bar proof** uses the task's sanctioned proxy question (cosine 0.25, zero FTS hits) with bars derived from the measured `top_score`; the server's per-turn log line (`threshold=0.20 deflected=False` / `threshold=0.27 deflected=True`) corroborates each flip.
4. **Regression (each in isolation)**: `test_admin_theme_tab` 5 ✓ · `test_api_tokens` 9 ✓ · `test_configurable_brand` 5 ✓ · `test_global_tuning` 6 ✓ · `test_admin_auth` 6 ✓ · `test_cache_busting` 4 ✓ · `test_wide_desktop_column` 3 ✓.
5. **Full suite**: 4065 passed · **coverage 99%** (>90% gate) · ruff clean · pyright 0 errors.
6. **Byte audit** (`scripts/api_payload_audit.py`, now includes the catalogue): `/api/admin/settings` = 23.6 KB identity / 3.3 KB gzip — **ok** (256 KB budget); ` :: api ` log line observed live for the PUT/DELETE routes; the write-side log line carries key + status only (A4 — never the value).
7. **DB clean**: `app_settings` 0 rows, `ui_settings` 0, no `e2e-*` tokens (module autouse fixture TRUNCATEs before + after every test).
8. Working tree only — no git operations; README/AGENTS already document the panel + audit (no changes needed).
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__06_e2e_settings_panel.a1.md.status
+1
View File
@@ -0,0 +1 @@
ok
.agents/reports/168_admin_settings_panel/168_admin_settings_panel__06_e2e_settings_panel.a1.validate
+134
View File
@@ -0,0 +1,134 @@
........................................................................ [ 1%]
........................................................................ [ 3%]
........................................................................ [ 5%]
........................................................................ [ 7%]
........................................................................ [ 8%]
........................................................................ [ 10%]
........................................................................ [ 12%]
........................................................................ [ 14%]
........................................................................ [ 15%]
........................................................................ [ 17%]
........................................................................ [ 19%]
........................................................................ [ 21%]
........................................................................ [ 23%]
........................................................................ [ 24%]
........................................................................ [ 26%]
........................................................................ [ 28%]
........................................................................ [ 30%]
........................................................................ [ 31%]
........................................................................ [ 33%]
........................................................................ [ 35%]
........................................................................ [ 37%]
........................................................................ [ 38%]
........................................................................ [ 40%]
........................................................................ [ 42%]
........................................................................ [ 44%]
........................................................................ [ 46%]
........................................................................ [ 47%]
........................................................................ [ 49%]
........................................................................ [ 51%]
........................................................................ [ 53%]
........................................................................ [ 54%]
........................................................................ [ 56%]
........................................................................ [ 58%]
........................................................................ [ 60%]
........................................................................ [ 61%]
........................................................................ [ 63%]
........................................................................ [ 65%]
........................................................................ [ 67%]
........................................................................ [ 69%]
........................................................................ [ 70%]
........................................................................ [ 72%]
........................................................................ [ 74%]
........................................................................ [ 76%]
........................................................................ [ 77%]
........................................................................ [ 79%]
........................................................................ [ 81%]
........................................................................ [ 83%]
........................................................................ [ 85%]
........................................................................ [ 86%]
........................................................................ [ 88%]
........................................................................ [ 90%]
........................................................................ [ 92%]
........................................................................ [ 93%]
........................................................................ [ 95%]
........................................................................ [ 97%]
........................................................................ [ 99%]
................................. [100%]
=============================== warnings summary ===============================
.venv/lib/python3.13/site-packages/fastapi/testclient.py:1
/var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
from starlette.testclient import TestClient as TestClient # noqa
-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.13.13-final-0 _______________
Name Stmts Miss Cover
--------------------------------------------------
app/__init__.py 1 0 100%
app/api/__init__.py 0 0 100%
app/api/admin_settings.py 108 0 100%
app/api/auth.py 52 0 100%
app/api/chat.py 280 1 99%
app/api/chat_images.py 50 0 100%
app/api/chats.py 110 0 100%
app/api/config.py 13 0 100%
app/api/doc_drafts.py 99 0 100%
app/api/docs.py 234 1 99%
app/api/git_sources.py 259 0 100%
app/api/health.py 10 0 100%
app/api/steering.py 42 0 100%
app/api/suggestions.py 33 0 100%
app/api/sync.py 204 0 100%
app/api/tokens.py 40 0 100%
app/api/ui_settings.py 55 0 100%
app/config.py 285 0 100%
app/core/__init__.py 0 0 100%
app/core/auth.py 45 0 100%
app/core/caching.py 124 0 100%
app/core/compression.py 59 0 100%
app/core/debugging.py 29 2 93%
app/core/docs_push.py 39 0 100%
app/core/errors.py 5 0 100%
app/core/http_cache.py 22 0 100%
app/core/logging.py 13 0 100%
app/core/rate_limit.py 44 0 100%
app/core/response_budget.py 63 0 100%
app/core/security_headers.py 20 0 100%
app/core/settings_catalog.py 18 0 100%
app/core/settings_overlay.py 111 0 100%
app/core/theming.py 38 0 100%
app/core/tokens.py 44 0 100%
app/db.py 22 0 100%
app/main.py 86 0 100%
app/models.py 141 0 100%
app/rag/__init__.py 0 0 100%
app/rag/agent.py 454 1 99%
app/rag/archive_upload.py 134 0 100%
app/rag/chunker.py 220 4 98%
app/rag/doc_dates.py 18 0 100%
app/rag/folder_summaries.py 134 0 100%
app/rag/git_sources.py 77 0 100%
app/rag/importer.py 841 4 99%
app/rag/llm.py 246 1 99%
app/rag/md_images.py 63 0 100%
app/rag/overview.py 78 0 100%
app/rag/pdf.py 192 0 100%
app/rag/prompts.py 156 0 100%
app/rag/retriever.py 252 3 99%
app/rag/scaffolding.py 55 0 100%
app/rag/source_removal.py 41 0 100%
app/rag/sources_meta.py 16 0 100%
app/rag/suggestions.py 27 0 100%
app/rag/summarizer.py 58 0 100%
app/schemas.py 532 0 100%
--------------------------------------------------
TOTAL 6392 17 99%
coverage gate: app/ 99% (>90%) OK
All checks passed!
0 errors, 0 warnings, 0 informations
WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
validation OK