60 lines
3.0 KiB
Markdown
60 lines
3.0 KiB
Markdown
# 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.
|