Files
summercms/.planning/phases/19-chat-and-chatchannels/19-DISCUSSION-LOG.md

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
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).