3.0 KiB
3.0 KiB
Phase 14: Domain jobs and external integrations - Discussion Log
Audit trail only. Do not use as input to planning, research, or execution agents. Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
Date: 2026-10-03 Phase: 14-domain-jobs-and-external-integrations Areas discussed: AI layer home + SDKs, Route scope, Feedback + sitemap, Vendor testing Todos folded: fetchguard-guarded-http-client, redacting-slog-handler
AI layer home + SDKs
| Question | Options | Selected |
|---|---|---|
| Where the Golem AI port lives | sm-golem-plugin repo / framework module / inside fonoteka | sm plugin repo. The user created sm-ai-plugin, then renamed it to sm-golem-plugin |
| Plugin ID | keep golem15.golem / rename golem15.ai | Keep golem15.golem, given the repo rename to sm-golem-plugin |
| Adapter transport | hand-rolled on guarded client / Anthropic SDK + plain OpenAI / both SDKs | Hand-rolled on guarded client |
| Global vision model settings | models repeater full / model only / config key | Models repeater, full, with admin screen |
| AIService surface | only what recognition needs / full minus faces | Full AIService minus faces |
| INTG-02 wording | reword at plan time / leave | Reword at plan time |
| base_url SSRF guard | guard user/org, trust admin / guard everything / mirror PHP | Guard user/org, trust admin |
Route scope
| Question | Options | Selected |
|---|---|---|
| 6 album Discogs/AI routes from Phase 12 | all in, reword SC4/SC5 / named routes only | All in |
| oauth-identities and /api/v1/fonoteka/me | out, flag for roadmap / fold in | Out; flag for roadmap |
| WR-02 CSV race | row lock/CAS / idempotent worker / both | Fix with row lock/CAS |
| Missing recordings | researcher checks / existing fixtures only | Researcher checks |
Feedback + sitemap
| Question | Options | Selected |
|---|---|---|
| Feedback repo | new sm-feedback-plugin / fonoteka.go app plugin | sm-feedback-plugin (repo created by the user) |
| Feedback depth | full / API + sync, no admin | Full |
| Sitemap | faithful minimal / full with admin editor / drop for Płytarium | Drop for Płytarium, and add a todo: the next port is a blog project (grzybyfunkcjonalne.pl or golem15.com) that needs sitemap 1:1 |
| G15Office verification | fake server only / plus live UAT | Fake server in tests only |
Vendor testing
| Question | Options | Selected |
|---|---|---|
| Upstream answers in replay | recorded upstream fakes / live keys behind tag / fakes + live smoke | Recorded upstream fakes |
| Time in tests | injected clock / real short timings | Injected clock |
| Rate-limit state store | researcher decides / memory / Postgres | Researcher decides against PHP |
Claude's Discretion
- Digest mail content, prune-notifications and reindex details (straight PHP ports), plugin package layout, plan split.
Deferred Ideas
- Sitemap 1:1 port for the next blog project (todo).
- oauth-identities + /api/v1/fonoteka/me need a roadmap home before Phase 15 (todo).
- Golem faces/CompreFace, ChatContextCollector.