# settings-panel

## Intent
The UI for the config store (AGENT.md §1.5) — manage forge hosts + tokens and the
git commit identity, replacing hand-editing `.env` for domain config. Projects
themselves are the subdirectories of the single root set in `.env`, and each
project's forge is derived from its git remote (not configured here). Served at
`/settings`.

## Public surface
- **Tag:** `<settings-panel>`
- **Fetches:** `GET /api/config/forges`, `GET /api/config/identity`.
- **Writes:**
  - Forges: `POST /api/config/forges` (add), `DELETE /api/config/forges/:id`.
  - Identity: `PUT /api/config/identity`.
- **Reports:** results via `toast` CustomEvents (needs `<toast-host>` on the page).

## History
- 2026-09-22: created — settings UI for the SQLite config store (forges, project
  dirs, git identity).
- 2026-09-22: removed the Project directories section — projects are now the
  subdirectories of the single `.env` root; only Forges + Git identity remain.

## Notes / gotchas
- Tokens are **write-only** from the client: the server returns only `hasToken`,
  never the value. Removing + re-adding a forge is how you rotate a token.
- Adding/removing a forge reapplies git auth (the server sets an `http.extraheader`
  per forge); changes take effect immediately.