3.0 KiB
3.0 KiB
Phase 19: Chat and ChatChannels - 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-09 Phase: 19-chat-and-chatchannels Areas discussed: Source and QuestStream, HTTP surface, Extension seams, Attachments and search
Source and QuestStream
| Question | Options | Selected |
|---|---|---|
| Frozen source | Wavepath HEADs (943b712 / b92fb42); latest develop at plan time | Wavepath HEADs |
| QuestStream leftovers | Schema only; port everything 1:1; drop column too | Drop column too ("won't be migrating QuestStream anytime soon") |
| canActAs | Keep in contract; drop it | Keep, "as generic as possible, no trace of QuestStream / Family / Child" |
| Migrations | Squashed baseline; port each version | Squashed baseline |
| family_id on adopted DBs | Drop if exists; ignore if present | Ignore if present |
HTTP surface
| Question | Options | Selected |
|---|---|---|
| Plugin HTTP surface | Service API + serializers; plus generic /_chat/api/v1; move /_wave community routes in | Plus generic /_chat/api/v1 |
| Legacy /api/chat routes | Drop both; port as-is | Drop both |
| SC3 parity proof | Golden payloads + events; test-host routes | Golden payloads + events |
| Frontend | No layer now; vue-chat-layer | No layer now |
| API shape | Mirror /_wave community; fresh REST design | Mirror /_wave community |
| Channel endpoints | /_chatchannels/api/v1; all under /_chat | /_chatchannels/api/v1 |
| Context in URL | Morph alias + id; conversation id only | Morph alias + id |
| Auth | jwt.auth + named buckets; app mounts with its guard | jwt.auth + named buckets |
Extension seams
| Question | Options | Selected |
|---|---|---|
| Context plug-in | Build-time morph registry; keep PHP class names | Build-time morph registry |
| Morph values in existing rows | Alias + legacy class map; rewrite on adoption | Rewrite on adoption |
| Message/User hooks | Typed festival events; GORM callbacks | Typed festival events |
| users.handle | chatchannels migration; move into sm-user-plugin | Move into sm-user-plugin |
| ChannelAccessResolver default | Deny-all + setter; derive from chat context | Deny-all + setter |
| user:{id} authorizer | sm-user-plugin; chat plugin | sm-user-plugin |
Attachments and search
| Question | Options | Selected |
|---|---|---|
| Storage | attach private + service route; signed URLs | attach private + service route |
| chat:migrate-attachments | Port it; skip | Skip |
| MessageIndex search | Port on beachcomber; defer | Port on beachcomber |
| Tests | Map PHP tests in test host; fresh Go tests | Map PHP tests |
Claude's Discretion
Go names, exact generic API paths, the thread summary job's queue, config key namespacing, lang neutral naming, whether the adoption rewrite is a migration or a command, plan split.
Deferred Ideas
vue-chat-layer; QuestStream chat features; chat:migrate-attachments (run on PHP); /_wave community routes (Wavepath port).