blumeops/docs/reference/services
Erich Blume db0512b5d4 Doc review: 5 stalest cards; scale back ai-docs rule; document heph CLI (#373)
## Doc review (5 stalest, all never-reviewed)

Each card was verified against live state (ArgoCD app list/health, manifests, 1Password item fields, Mealie API probe) and stamped `last-reviewed: 2026-06-09`.

| Card | Findings fixed |
|------|----------------|
| `reference/services/argocd.md` | Added Authentik SSO (public PKCE client, `--sso` login, admins→role:admin RBAC); documented dual-cluster management (minikube + ringtail k3s at `ringtail.tail8d86e.ts.net:6443`); corrected sync policy — the `apps` root is **manual**, not automated |
| `reference/services/authentik.md` | Blueprint list grown from 5 to 10 files; OIDC client table now lists all 8 clients with types; secrets table updated to `postgresql-*` fields and per-client secrets |
| `reference/services/grafana.md` | TeslaMate datasource moved to `pg.ops.eblu.me:5434` (ringtail); dashboard inventory refreshed (20 provisioned ConfigMaps); TeslaMate dashboards documented as init-container fetch from forge mirror at pinned tag; SSO role mapping wording corrected (Admin only for `admins` group) |
| `reference/infrastructure/unifi.md` | UnPoller image is now locally built (`registry.ops.eblu.me/blumeops/unpoller`); verified namespace/port |
| `how-to/mealie/plan-a-meal.md` | Procedure verified; **found the stored API token (`op://blumeops/mealie/credential`) returns 401** — operational fix in progress, doc content unchanged |

## AGENTS.md

- **Scaled back the ai-docs rule** (per discussion): agents now start by finding and reading relevant docs; `mise run ai-docs` (~130K tokens now) and `ai-sources` become opt-in bulk loads. `agent-change-process.md` updated to match. The `ai-docs` mise task itself is kept for now — happy to retire it in a follow-up if desired.
- **Documented the heph CLI** task workflow (list/show/context/log read paths; done/drop/skip/log/edit/task write paths) so future sessions can read and manipulate Blumeops tasks without rediscovery.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: #373
2026-06-09 16:05:01 -07:00
..
1password.md C0: review 1password reference card 2026-05-22 21:29:11 -07:00
alloy.md Recurring review sweep: 4 doc cards + nvidia-device-plugin v0.19.2 (#366) 2026-06-04 13:37:02 -07:00
argocd.md Doc review: 5 stalest cards; scale back ai-docs rule; document heph CLI (#373) 2026-06-09 16:05:01 -07:00
authentik.md Doc review: 5 stalest cards; scale back ai-docs rule; document heph CLI (#373) 2026-06-09 16:05:01 -07:00
automounter.md
borgmatic.md C0: retire Todoist blumeops-tasks; point task discovery at heph 2026-06-03 21:32:10 -07:00
caddy.md
cv.md C1: migrate cv + docs from minikube to indri-native (#342) 2026-04-29 14:55:11 -07:00
devpi.md Migrate devpi from minikube to indri (launchd) (#341) 2026-04-29 13:38:36 -07:00
docs.md C1: migrate cv + docs from minikube to indri-native (#342) 2026-04-29 14:55:11 -07:00
flyio-proxy.md
forgejo-runner.md
forgejo.md
frigate.md
grafana.md Doc review: 5 stalest cards; scale back ai-docs rule; document heph CLI (#373) 2026-06-09 16:05:01 -07:00
hephaestus.md heph Authentik: grant offline_access scope (fixes spoke sync refresh-token 400) 2026-06-06 18:07:13 -07:00
immich.md
jellyfin.md C0: review jellyfin, upgrade indri to 10.11.11 (security fixes) 2026-06-08 06:35:23 -07:00
kingfisher.md
kiwix.md C0: kiwix — doc review, fix Adding Archives source path 2026-05-04 17:46:16 -07:00
loki.md
mealie.md
miniflux.md
navidrome.md
ntfy.md Recurring review sweep: 4 doc cards + nvidia-device-plugin v0.19.2 (#366) 2026-06-04 13:37:02 -07:00
nvidia-device-plugin.md
ollama.md C0: review ollama doc — refresh image, models, last-reviewed 2026-05-01 10:42:33 -07:00
paperless.md
postgresql.md
prometheus.md
prowler.md Retire Prowler image + IaC scans (keep K8s CIS only) (#372) 2026-06-08 09:30:09 -07:00
shower-app.md C1: deploy adelaide-baby-shower-app to ringtail k3s (#349) 2026-05-11 13:47:18 -07:00
snowflake-proxy.md
tempo.md Recurring review sweep: 4 doc cards + nvidia-device-plugin v0.19.2 (#366) 2026-06-04 13:37:02 -07:00
teslamate.md
transmission.md
zot.md C0: fix op item edit syntax in zot key rotation 2026-05-22 21:50:43 -07:00