feat: Forgejo wiki updated with 9 files (1 new, 8 modified) covering M0…

- "Personality-Profiles.md" - "Home.md" - "Highlights.md" - "Chat-Engine.md" - "Data-Model.md" - "API-Surface.md" - "Frontend.md" - "Decisions.md" GSD-Task: S07/T01
2026-04-04 08:46:09 +00:00 · 2026-04-04 08:46:09 +00:00 · 66f0f51219
commit 66f0f51219
parent eab362d897
8 changed files with 567 additions and 2 deletions
--- a/.gsd/milestones/M022/M022-ROADMAP.md
+++ b/.gsd/milestones/M022/M022-ROADMAP.md
@ -11,5 +11,5 @@ Creator-facing tools take shape: shorts queue, follow system, chat widget (UI on
 | S03 | [A] Chat Widget Shell (UI Only) | low | — | ✅ | Chat bubble on creator profile pages with conversation UI, typing indicator, suggested questions |
 | S04 | [B] Multi-Turn Conversation Memory | medium | — | ✅ | Multi-turn conversations maintain context across messages using Redis-backed history |
 | S05 | [B] Highlight Detection v2 (Audio Signals) | medium | — | ✅ | Highlight detection uses audio energy analysis (librosa) alongside transcript signals for improved scoring |
-| S06 | [B] Personality Profile Extraction | high | — | ⬜ | Personality profiles extracted for 3+ creators showing distinct vocabulary, tone, and style markers |
+| S06 | [B] Personality Profile Extraction | high | — | ✅ | Personality profiles extracted for 3+ creators showing distinct vocabulary, tone, and style markers |
 | S07 | Forgejo KB Update — Follow, Personality, Highlights | low | S01, S02, S03, S04, S05, S06 | ⬜ | Forgejo wiki updated with follow system, personality system, highlight engine v2 |
--- a/.gsd/milestones/M022/slices/S06/S06-SUMMARY.md
+++ b/.gsd/milestones/M022/slices/S06/S06-SUMMARY.md
@ -0,0 +1,118 @@
+---
+id: S06
+parent: M022
+milestone: M022
+provides:
+  - Creator.personality_profile JSONB column with extraction pipeline
+  - PersonalityProfile Pydantic validation model
+  - POST /admin/creators/{slug}/extract-profile endpoint
+  - PersonalityProfile frontend component on creator detail pages
+requires:
+  []
+affects:
+  - S07
+key_files:
+  - prompts/personality_extraction.txt
+  - backend/pipeline/stages.py
+  - backend/schemas.py
+  - backend/models.py
+  - backend/routers/admin.py
+  - backend/routers/creators.py
+  - alembic/versions/023_add_personality_profile.py
+  - frontend/src/components/PersonalityProfile.tsx
+  - frontend/src/api/creators.ts
+  - frontend/src/pages/CreatorDetail.tsx
+  - frontend/src/App.css
+key_decisions:
+  - Used response_model=object to trigger JSON mode with manual parse + Pydantic validation for personality extraction (clearer error handling on nested schema)
+  - Used dedicated TypeScript interfaces for personality profile sub-objects rather than inline types
+patterns_established:
+  - 3-tier transcript sampling (small/medium/large) with topic-diverse random sampling via Redis classification data
+  - LLM extraction → Pydantic validation → JSONB storage pattern for structured profile data
+  - Admin trigger endpoint pattern for on-demand pipeline tasks
+observability_surfaces:
+  - pipeline_events table with stage='personality_extraction' for start/complete/error tracking
+  - Creator.personality_profile.extracted_at and transcript_sample_size metadata for extraction provenance
+drill_down_paths:
+  - .gsd/milestones/M022/slices/S06/tasks/T01-SUMMARY.md
+  - .gsd/milestones/M022/slices/S06/tasks/T02-SUMMARY.md
+  - .gsd/milestones/M022/slices/S06/tasks/T03-SUMMARY.md
+duration: ""
+verification_result: passed
+completed_at: 2026-04-04T08:33:03.220Z
+blocker_discovered: false
+---
+
+# S06: [B] Personality Profile Extraction
+
+**Full personality profile extraction pipeline: JSONB storage, LLM-powered analysis of creator transcripts with 3-tier sampling, Pydantic validation, admin trigger endpoint, and collapsible frontend component.**
+
+## What Happened
+
+Three tasks delivered end-to-end personality profile extraction for creators.
+
+T01 laid the plumbing: `personality_profile` JSONB column on the Creator model, Alembic migration 023, CreatorDetail schema field, and passthrough in the GET /creators/{slug} endpoint. Pure data layer, no logic.
+
+T02 built the extraction pipeline. The prompt template (`prompts/personality_extraction.txt`) instructs the LLM to analyze transcript excerpts for vocabulary patterns (signature phrases, jargon level, filler words, distinctive terms), tone (formality, energy, humor, teaching style), and style markers (explanation approach, analogies, sound words, audience engagement), producing structured JSON. The `_sample_creator_transcripts()` helper implements three tiers: small creators (&lt;20K chars) use all text, medium (20K-60K) take 300-char excerpts per moment, large (&gt;60K) do topic-diverse random sampling via Redis classification data with deterministic seeding. The `extract_personality_profile` Celery task joins KeyMoment→SourceVideo to load transcripts, samples them, calls the LLM, validates the response with the PersonalityProfile Pydantic model (with nested VocabularyProfile, ToneProfile, StyleMarkersProfile sub-models), attaches metadata (extracted_at, transcript_sample_size, model_used), and stores the result. Handles zero-transcript creators (early return), invalid JSON (retry), and validation failures (retry). Pipeline events emitted for observability. Admin endpoint `POST /admin/creators/{slug}/extract-profile` queues the task.
+
+T03 added the frontend: updated CreatorDetailResponse TypeScript interface with dedicated sub-interfaces, created PersonalityProfile.tsx with collapsible section (CSS grid-template-rows 0fr/1fr animation), three sub-cards (Teaching Style, Vocabulary, Style), pill badges for descriptors/phrases/terms, boolean checkmark/cross indicators for style markers, summary paragraph, and metadata footer. Wired into CreatorDetail.tsx. Handles null profiles gracefully (renders nothing). TypeScript compiles clean, production build succeeds.
+
+## Verification
+
+All slice-level verification checks pass:
+- Creator model has personality_profile attribute ✅
+- CreatorDetail schema includes personality_profile field ✅
+- PersonalityProfile Pydantic validator importable ✅
+- extract_personality_profile Celery task importable ✅
+- Alembic migration 023 exists ✅
+- Prompt template exists ✅
+- PersonalityProfile.tsx component exists ✅
+- Creator router references personality_profile ✅
+- Admin router has extract-profile endpoint ✅
+- PersonalityProfile wired into CreatorDetail page ✅
+- TypeScript compiles (tsc --noEmit) ✅
+- Frontend production build succeeds ✅
+
+## Requirements Advanced
+
+None.
+
+## Requirements Validated
+
+None.
+
+## New Requirements Surfaced
+
+None.
+
+## Requirements Invalidated or Re-scoped
+
+None.
+
+## Deviations
+
+None.
+
+## Known Limitations
+
+- Profile extraction requires running the Celery task manually via the admin endpoint — no automatic extraction on new creator ingestion yet.
+- The admin endpoint has no auth guard beyond the /admin path prefix.
+- Topic-diverse sampling depends on Redis classification data; falls back to random sampling if Redis data is missing.
+
+## Follow-ups
+
+None.
+
+## Files Created/Modified
+
+- `backend/models.py` — Added personality_profile JSONB column to Creator model
+- `backend/schemas.py` — Added PersonalityProfile validation model with nested sub-models + CreatorDetail field
+- `backend/routers/creators.py` — Passes personality_profile through in get_creator endpoint
+- `backend/routers/admin.py` — Added POST /admin/creators/{slug}/extract-profile endpoint
+- `backend/pipeline/stages.py` — Added _sample_creator_transcripts() helper and extract_personality_profile Celery task
+- `alembic/versions/023_add_personality_profile.py` — Migration adding personality_profile JSONB column to creators table
+- `prompts/personality_extraction.txt` — LLM prompt template for personality extraction
+- `frontend/src/components/PersonalityProfile.tsx` — New collapsible personality profile component with 3 sub-cards
+- `frontend/src/api/creators.ts` — Updated CreatorDetailResponse type with personality_profile interfaces
+- `frontend/src/pages/CreatorDetail.tsx` — Wired PersonalityProfile component into page
+- `frontend/src/App.css` — Added personality profile CSS styles
--- a/.gsd/milestones/M022/slices/S06/S06-UAT.md
+++ b/.gsd/milestones/M022/slices/S06/S06-UAT.md
@ -0,0 +1,118 @@
+# S06: [B] Personality Profile Extraction — UAT
+
+**Milestone:** M022
+**Written:** 2026-04-04T08:33:03.220Z
+
+## UAT: Personality Profile Extraction
+
+### Preconditions
+- Chrysopedia stack running on ub01 (API, worker, web, DB, Redis)
+- Alembic migration 023 applied (`docker exec chrysopedia-api alembic upgrade head`)
+- At least 3 creators with ingested videos and key moments with transcripts
+
+---
+
+### Test 1: Schema and migration
+**Steps:**
+1. SSH to ub01, connect to chrysopedia-db
+2. Run `\d creators` to inspect the table schema
+
+**Expected:** `personality_profile` column exists with type `jsonb`, nullable
+
+---
+
+### Test 2: API passthrough (null profile)
+**Steps:**
+1. Pick a creator who has NOT had extraction run
+2. `curl http://ub01:8096/api/creators/{slug}`
+
+**Expected:** Response includes `"personality_profile": null`
+
+---
+
+### Test 3: Trigger extraction for a creator
+**Steps:**
+1. `curl -X POST http://ub01:8096/api/admin/creators/{slug}/extract-profile`
+2. Check response
+
+**Expected:** `{"status": "queued", "creator_id": "<uuid>"}`
+
+---
+
+### Test 4: Verify extraction completes
+**Steps:**
+1. After triggering extraction in Test 3, watch worker logs: `docker logs -f chrysopedia-worker`
+2. Wait for personality_extraction complete event
+3. `curl http://ub01:8096/api/creators/{slug}`
+
+**Expected:**
+- Worker logs show personality_extraction start and complete events
+- API response `personality_profile` is populated with:
+  - `vocabulary` object (signature_phrases array, technical_jargon_level string, filler_words array, distinctive_terms array)
+  - `tone` object (formality, energy, humor_frequency, teaching_style strings, descriptors array)
+  - `style_markers` object (explanation_approach string, uses_analogies boolean, uses_sound_words boolean, self_references_frequency string, audience_engagement string)
+  - `summary` string (one paragraph)
+  - `extracted_at` timestamp
+  - `transcript_sample_size` integer
+  - `model_used` string
+
+---
+
+### Test 5: Extract profiles for 3 different creators
+**Steps:**
+1. Trigger extraction for 3 creators with different content styles
+2. Compare personality_profile.summary for each
+
+**Expected:** Summaries describe meaningfully different personality traits. Vocabulary and tone fields reflect distinct styles (not generic boilerplate repeated across creators).
+
+---
+
+### Test 6: Frontend display
+**Steps:**
+1. Navigate to `http://ub01:8096/creators/{slug}` for a creator with a profile
+2. Look for "Personality Profile" section below bio/stats
+
+**Expected:**
+- Collapsible section heading visible
+- Click to expand: smooth animation (no jump)
+- Summary paragraph at top
+- Three cards: Teaching Style, Vocabulary, Style
+- Pill badges for descriptors, signature phrases, distinctive terms
+- Checkmark/cross indicators for boolean style markers
+- Metadata footer with extraction date and sample size
+
+---
+
+### Test 7: Frontend handles null profile
+**Steps:**
+1. Navigate to `http://ub01:8096/creators/{slug}` for a creator WITHOUT a profile
+
+**Expected:** No personality profile section rendered. No errors in browser console.
+
+---
+
+### Test 8: Zero-transcript creator (edge case)
+**Steps:**
+1. Find or create a creator with no key moments or no transcripts
+2. `curl -X POST http://ub01:8096/api/admin/creators/{slug}/extract-profile`
+3. Check worker logs
+
+**Expected:** Worker logs a warning about no transcripts. No profile stored. No crash.
+
+---
+
+### Test 9: Re-extraction overwrites
+**Steps:**
+1. Run extraction for a creator who already has a profile
+2. Compare `extracted_at` timestamps before and after
+
+**Expected:** Profile is overwritten with new extraction. `extracted_at` updated to current time.
+
+---
+
+### Test 10: Pipeline observability
+**Steps:**
+1. After running extractions, check pipeline events:
+   `SELECT stage, event_type, created_at FROM pipeline_events WHERE stage='personality_extraction' ORDER BY created_at DESC LIMIT 10;`
+
+**Expected:** Start and complete events for each extraction, with creator_id in payload.
--- a/.gsd/milestones/M022/slices/S06/tasks/T03-VERIFY.json
+++ b/.gsd/milestones/M022/slices/S06/tasks/T03-VERIFY.json
@ -0,0 +1,48 @@
+{
+  "schemaVersion": 1,
+  "taskId": "T03",
+  "unitId": "M022/S06/T03",
+  "timestamp": 1775291497549,
+  "passed": false,
+  "discoverySource": "task-plan",
+  "checks": [
+    {
+      "command": "cd frontend",
+      "exitCode": 0,
+      "durationMs": 6,
+      "verdict": "pass"
+    },
+    {
+      "command": "npx tsc --noEmit",
+      "exitCode": 1,
+      "durationMs": 790,
+      "verdict": "fail"
+    },
+    {
+      "command": "npm run build",
+      "exitCode": 254,
+      "durationMs": 84,
+      "verdict": "fail"
+    },
+    {
+      "command": "test -f src/components/PersonalityProfile.tsx",
+      "exitCode": 1,
+      "durationMs": 7,
+      "verdict": "fail"
+    },
+    {
+      "command": "grep -q 'PersonalityProfile' src/pages/CreatorDetail.tsx",
+      "exitCode": 2,
+      "durationMs": 6,
+      "verdict": "fail"
+    },
+    {
+      "command": "echo 'all OK'",
+      "exitCode": 0,
+      "durationMs": 4,
+      "verdict": "pass"
+    }
+  ],
+  "retryAttempt": 1,
+  "maxRetries": 2
+}
--- a/.gsd/milestones/M022/slices/S07/S07-PLAN.md
+++ b/.gsd/milestones/M022/slices/S07/S07-PLAN.md
@ -1,6 +1,39 @@
 # S07: Forgejo KB Update — Follow, Personality, Highlights

-**Goal:** Document new systems in Forgejo knowledgebase
+**Goal:** Forgejo wiki updated with M022 feature documentation covering follow system, personality profiles, highlight detection v2, multi-turn chat memory, chat widget, highlight review queue, and creator tiers UI.
 **Demo:** After this: Forgejo wiki updated with follow system, personality system, highlight engine v2

 ## Tasks
+- [x] **T01: Forgejo wiki updated with 9 files (1 new, 8 modified) covering M022 features: follow system, personality profiles, highlight v2, chat widget, multi-turn memory, creator tiers** — Documentation-only task. SSH to ub01, clone the Forgejo wiki repo, create one new page (Personality-Profiles.md), update 8 existing pages (Home, Highlights, Chat-Engine, Data-Model, API-Surface, Frontend, Decisions, _Sidebar), commit, and push via HTTPS.
+
+**CRITICAL:** Never use the Forgejo wiki PATCH API — it corrupts pages (see KNOWLEDGE.md). Always use git clone → edit → push.
+
+**Content sources:** All content comes from the S01-S06 summaries inlined in the slice research doc. Key details:
+
+**New page — Personality-Profiles.md:**
+- Extraction pipeline overview: 3-tier transcript sampling (small <20K all text, medium 20K-60K 300-char excerpts, large >60K topic-diverse random)
+- PersonalityProfile JSONB schema: vocabulary (signature_phrases, jargon_level, filler_words, distinctive_terms), tone (formality, energy, humor, teaching_style), style_markers (explanation_approach, analogies, sound_words, audience_engagement)
+- Admin trigger endpoint: POST /admin/creators/{slug}/extract-profile
+- Frontend component: collapsible section with 3 sub-cards (Teaching Style, Vocabulary, Style)
+- Prompt template location: prompts/personality_extraction.txt
+
+**Home.md:** Add Follow System, Personality Profiles, Creator Tiers, Chat Widget, Highlight v2 to feature list
+
+**Highlights.md:** Update from 7→10 dimensions. Add new scoring dimensions table (speech_rate_variance ~0.07, pause_density ~0.08, speaking_pace ~0.07). Add trim_start/trim_end columns. Add creator-scoped highlight endpoints (GET list, GET detail, PATCH status, PATCH trim). Update score_breakdown JSON to show all 10 dimensions. Note neutral fallback (0.5) when word_timings unavailable.
+
+**Chat-Engine.md:** Add multi-turn conversation memory section: Redis key pattern chrysopedia:chat:{conversation_id} with 1h TTL, 10 turn pairs max (20 messages), conversation_id auto-generated UUID when omitted, returned in SSE done event. Add ChatWidget component section: floating bubble, creator-scoped, suggested questions, responsive at 640px breakpoint. Update API endpoint table with conversation_id field on POST /chat.
+
+**Data-Model.md:** Add CreatorFollow model (user_id FK + creator_id FK, unique constraint). Add personality_profile JSONB on Creator. Add trim_start/trim_end Float on HighlightCandidate. Reference migrations 021, 022, 023.
+
+**API-Surface.md:** Add follow endpoints (POST follow, DELETE unfollow, GET status, GET my-follows). Add creator highlight endpoints (GET list, GET detail, PATCH status, PATCH trim). Add personality extraction endpoint (POST /admin/creators/{slug}/extract-profile). Update chat endpoint with conversation_id param. Update total endpoint count.
+
+**Frontend.md:** Add HighlightQueue page (filter tabs, score bars, approve/discard/trim). Add CreatorTiers page (Free/Pro/Premium cards, Coming Soon modals). Add ChatWidget component (floating bubble, SSE streaming, citations). Add PersonalityProfile component (collapsible, 3 sub-cards). Note follow button on CreatorDetail.
+
+**Decisions.md:** Add decisions D031-D041. Get the actual decision text from the project's .gsd/DECISIONS.md file.
+
+**_Sidebar.md:** Add Personality-Profiles link under Features section.
+  - Estimate: 45m
+  - Files: Personality-Profiles.md (new, in wiki clone), Home.md (update, in wiki clone), Highlights.md (update, in wiki clone), Chat-Engine.md (update, in wiki clone), Data-Model.md (update, in wiki clone), API-Surface.md (update, in wiki clone), Frontend.md (update, in wiki clone), Decisions.md (update, in wiki clone), _Sidebar.md (update, in wiki clone)
+  - Verify: 1. `git push` exit code 0
+2. `curl -sf 'https://git.xpltd.co/api/v1/repos/xpltdco/chrysopedia/wiki/pages?limit=50' -H 'accept: application/json' | python3 -c "import sys,json; pages=json.load(sys.stdin); print(len(pages)); assert len(pages)>=20, f'Expected >=20, got {len(pages)}'"` — page count ≥ 20
+3. `curl -sf 'https://git.xpltd.co/api/v1/repos/xpltdco/chrysopedia/wiki/page/Personality-Profiles' -H 'accept: application/json' | python3 -c "import sys,json; p=json.load(sys.stdin); assert 'extraction' in p.get('content_base64','').lower() or len(p.get('content_base64',''))>100"` — new page exists
--- a/.gsd/milestones/M022/slices/S07/S07-RESEARCH.md
+++ b/.gsd/milestones/M022/slices/S07/S07-RESEARCH.md
@ -0,0 +1,92 @@
+# S07 Research: Forgejo KB Update — Follow, Personality, Highlights
+
+## Summary
+
+Documentation-only slice. Update the Forgejo wiki with M022 feature documentation covering: follow system, personality profiles, highlight detection v2 (audio signals), multi-turn chat memory, chat widget, highlight review queue, and creator tiers UI. Straightforward application of the established wiki update pattern (M019/S06 → M020/S07 → M021/S08).
+
+## Recommendation
+
+Single task: clone wiki repo on ub01, update existing pages + create new page, commit, push. Content comes from the S01-S06 summaries already preloaded. No code changes, no tests.
+
+## Implementation Landscape
+
+### Established Pattern
+
+1. **SSH to ub01**, clone wiki: `git clone https://git.xpltd.co/xpltdco/chrysopedia.wiki.git`
+2. Write/update markdown files in the clone
+3. `git add . && git commit && git push` via HTTPS with Forgejo token
+4. **Never use the PATCH API** — it corrupts pages (KNOWLEDGE.md lesson)
+5. HTTPS only (SSH port 2222 unreachable from ub01)
+
+### Current Wiki State (19 pages + sidebar)
+
+Pages: Home, Architecture, Authentication, Impersonation, Data-Model, Pipeline, Player, Chat-Engine, Search-Retrieval, Highlights, API-Surface, Frontend, Configuration, Decisions, Deployment, Monitoring, Development-Guide, Agent-Context, _Sidebar
+
+### New Pages to Create
+
+1. **Personality-Profiles.md** — Extraction pipeline, prompt template, 3-tier sampling, PersonalityProfile schema, JSONB storage, admin trigger endpoint, frontend component
+
+### Pages to Update
+
+| Page | What Changes | Why |
+|------|-------------|-----|
+| **Home.md** | Update feature list, add Follow/Personality/Tiers mentions | New M022 features |
+| **Highlights.md** | Update from 7→10 dimensions, add audio proxy signals, add trim columns, add creator-scoped endpoints, update scoring table and score_breakdown JSON | S01 (creator endpoints + trim) and S05 (v2 scoring) |
+| **Chat-Engine.md** | Add multi-turn conversation memory section (Redis history, conversation_id threading, SSE done event update), add ChatWidget component section, update API endpoint table with conversation_id field | S03 (widget) and S04 (multi-turn) |
+| **Data-Model.md** | Add CreatorFollow model, personality_profile JSONB on Creator, trim_start/trim_end on HighlightCandidate | S01, S02, S06 |
+| **API-Surface.md** | Add follow endpoints (4), creator highlight endpoints (4), personality extraction endpoint (1), update chat endpoint with conversation_id. Update endpoint count. | S01, S02, S04, S06 |
+| **Frontend.md** | Add HighlightQueue, CreatorTiers, ChatWidget, PersonalityProfile components/pages | S01, S02, S03, S06 |
+| **Decisions.md** | Add D031-D041 (11 new decisions) | All missing since last wiki update |
+| **_Sidebar.md** | Add Personality-Profiles link under Features | New page |
+
+### Content Sources (all from preloaded summaries)
+
+- **S01 summary** → Creator highlight endpoints (4 endpoints), trim columns, HighlightQueue page
+- **S02 summary** → CreatorFollow model, follow endpoints (4), CreatorTiers page, migration 022
+- **S03 summary** → ChatWidget component, suggested questions, responsive layout
+- **S04 summary** → Multi-turn memory, Redis history, conversation_id, ChatDoneMeta type
+- **S05 summary** → 10-dimension scoring, audio proxy signals (speech_rate_variance, pause_density, speaking_pace), word timing extraction, D041
+- **S06 summary** → PersonalityProfile schema, extraction pipeline, 3-tier sampling, admin endpoint, frontend component, migration 023
+
+### Key Details to Document
+
+**Highlights v2 (10 dimensions):**
+| New Dimension | Weight | Source |
+|--------------|--------|--------|
+| speech_rate_variance | ~0.07 | Word-level timing CoV in 5s windows |
+| pause_density | ~0.08 | Inter-word gap weighting (>0.5s short, >1.0s long) |
+| speaking_pace | ~0.07 | Bell-curve around 3-5 WPS optimal pace |
+
+Original 7 dimensions reduced proportionally. New dims default to 0.5 (neutral) when word_timings unavailable.
+
+**Multi-turn conversation:**
+- Redis key: `chrysopedia:chat:{conversation_id}` with 1h TTL
+- History: 10 turn pairs max (20 messages)
+- conversation_id: auto-generated UUID when omitted, returned in SSE done event
+- Frontend: ChatWidget uses crypto.randomUUID(), resets on close; ChatPage has New Conversation button
+
+**Follow system:**
+- CreatorFollow model: user_id FK + creator_id FK, unique constraint
+- Idempotent via INSERT ON CONFLICT DO NOTHING
+- Endpoints: POST follow, DELETE unfollow, GET status, GET my-follows
+- follower_count on CreatorDetail response
+
+**Personality extraction:**
+- 3-tier sampling: small (<20K) all text, medium (20K-60K) 300-char excerpts, large (>60K) topic-diverse random
+- JSONB schema: vocabulary (signature_phrases, jargon_level, filler_words, distinctive_terms), tone (formality, energy, humor, teaching_style), style_markers (explanation_approach, analogies, sound_words, audience_engagement)
+- Admin trigger: POST /admin/creators/{slug}/extract-profile
+
+### Verification
+
+- `git push` succeeds (exit 0)
+- Page count via API: `curl https://git.xpltd.co/api/v1/repos/xpltdco/chrysopedia/wiki/pages` shows 20 pages (19 + 1 new)
+
+### Constraints
+
+- Must run on ub01 (git credentials configured there)
+- HTTPS push only
+- Forgejo personal access token already set up (M020/S07)
+
+### Task Decomposition Suggestion
+
+**Single task (T01):** Clone wiki, create 1 new page + update 8 existing pages + sidebar, commit, push. Pure markdown writing — no code, no tests, no builds. Splitting further would just add overhead.
--- a/.gsd/milestones/M022/slices/S07/tasks/T01-PLAN.md
+++ b/.gsd/milestones/M022/slices/S07/tasks/T01-PLAN.md
@ -0,0 +1,64 @@
+---
+estimated_steps: 17
+estimated_files: 9
+skills_used: []
+---
+
+# T01: Clone wiki, create Personality-Profiles page, update 8 existing pages + sidebar, push
+
+Documentation-only task. SSH to ub01, clone the Forgejo wiki repo, create one new page (Personality-Profiles.md), update 8 existing pages (Home, Highlights, Chat-Engine, Data-Model, API-Surface, Frontend, Decisions, _Sidebar), commit, and push via HTTPS.
+
+**CRITICAL:** Never use the Forgejo wiki PATCH API — it corrupts pages (see KNOWLEDGE.md). Always use git clone → edit → push.
+
+**Content sources:** All content comes from the S01-S06 summaries inlined in the slice research doc. Key details:
+
+**New page — Personality-Profiles.md:**
+- Extraction pipeline overview: 3-tier transcript sampling (small <20K all text, medium 20K-60K 300-char excerpts, large >60K topic-diverse random)
+- PersonalityProfile JSONB schema: vocabulary (signature_phrases, jargon_level, filler_words, distinctive_terms), tone (formality, energy, humor, teaching_style), style_markers (explanation_approach, analogies, sound_words, audience_engagement)
+- Admin trigger endpoint: POST /admin/creators/{slug}/extract-profile
+- Frontend component: collapsible section with 3 sub-cards (Teaching Style, Vocabulary, Style)
+- Prompt template location: prompts/personality_extraction.txt
+
+**Home.md:** Add Follow System, Personality Profiles, Creator Tiers, Chat Widget, Highlight v2 to feature list
+
+**Highlights.md:** Update from 7→10 dimensions. Add new scoring dimensions table (speech_rate_variance ~0.07, pause_density ~0.08, speaking_pace ~0.07). Add trim_start/trim_end columns. Add creator-scoped highlight endpoints (GET list, GET detail, PATCH status, PATCH trim). Update score_breakdown JSON to show all 10 dimensions. Note neutral fallback (0.5) when word_timings unavailable.
+
+**Chat-Engine.md:** Add multi-turn conversation memory section: Redis key pattern chrysopedia:chat:{conversation_id} with 1h TTL, 10 turn pairs max (20 messages), conversation_id auto-generated UUID when omitted, returned in SSE done event. Add ChatWidget component section: floating bubble, creator-scoped, suggested questions, responsive at 640px breakpoint. Update API endpoint table with conversation_id field on POST /chat.
+
+**Data-Model.md:** Add CreatorFollow model (user_id FK + creator_id FK, unique constraint). Add personality_profile JSONB on Creator. Add trim_start/trim_end Float on HighlightCandidate. Reference migrations 021, 022, 023.
+
+**API-Surface.md:** Add follow endpoints (POST follow, DELETE unfollow, GET status, GET my-follows). Add creator highlight endpoints (GET list, GET detail, PATCH status, PATCH trim). Add personality extraction endpoint (POST /admin/creators/{slug}/extract-profile). Update chat endpoint with conversation_id param. Update total endpoint count.
+
+**Frontend.md:** Add HighlightQueue page (filter tabs, score bars, approve/discard/trim). Add CreatorTiers page (Free/Pro/Premium cards, Coming Soon modals). Add ChatWidget component (floating bubble, SSE streaming, citations). Add PersonalityProfile component (collapsible, 3 sub-cards). Note follow button on CreatorDetail.
+
+**Decisions.md:** Add decisions D031-D041. Get the actual decision text from the project's .gsd/DECISIONS.md file.
+
+**_Sidebar.md:** Add Personality-Profiles link under Features section.
+
+## Inputs
+
+- ``.gsd/DECISIONS.md` — decisions D031-D041 to copy into wiki Decisions page`
+- ``.gsd/milestones/M022/slices/S01/S01-SUMMARY.md` — highlight queue content`
+- ``.gsd/milestones/M022/slices/S02/S02-SUMMARY.md` — follow system content`
+- ``.gsd/milestones/M022/slices/S03/S03-SUMMARY.md` — chat widget content`
+- ``.gsd/milestones/M022/slices/S04/S04-SUMMARY.md` — multi-turn memory content`
+- ``.gsd/milestones/M022/slices/S05/S05-SUMMARY.md` — highlight v2 content`
+- ``.gsd/milestones/M022/slices/S06/S06-SUMMARY.md` — personality profile content`
+
+## Expected Output
+
+- ``Personality-Profiles.md` — new wiki page in Forgejo`
+- ``Home.md` — updated with M022 features`
+- ``Highlights.md` — updated with v2 scoring and creator endpoints`
+- ``Chat-Engine.md` — updated with multi-turn memory and widget`
+- ``Data-Model.md` — updated with new models and columns`
+- ``API-Surface.md` — updated with new endpoints`
+- ``Frontend.md` — updated with new components`
+- ``Decisions.md` — updated with D031-D041`
+- ``_Sidebar.md` — updated with Personality-Profiles link`
+
+## Verification
+
+1. `git push` exit code 0
+2. `curl -sf 'https://git.xpltd.co/api/v1/repos/xpltdco/chrysopedia/wiki/pages?limit=50' -H 'accept: application/json' | python3 -c "import sys,json; pages=json.load(sys.stdin); print(len(pages)); assert len(pages)>=20, f'Expected >=20, got {len(pages)}'"` — page count ≥ 20
+3. `curl -sf 'https://git.xpltd.co/api/v1/repos/xpltdco/chrysopedia/wiki/page/Personality-Profiles' -H 'accept: application/json' | python3 -c "import sys,json; p=json.load(sys.stdin); assert 'extraction' in p.get('content_base64','').lower() or len(p.get('content_base64',''))>100"` — new page exists
--- a/.gsd/milestones/M022/slices/S07/tasks/T01-SUMMARY.md
+++ b/.gsd/milestones/M022/slices/S07/tasks/T01-SUMMARY.md
@ -0,0 +1,92 @@
+---
+id: T01
+parent: S07
+milestone: M022
+provides: []
+requires: []
+affects: []
+key_files: ["Personality-Profiles.md", "Home.md", "Highlights.md", "Chat-Engine.md", "Data-Model.md", "API-Surface.md", "Frontend.md", "Decisions.md", "_Sidebar.md"]
+key_decisions: ["Grouped decisions by theme instead of flat table for readability at 40+ entries"]
+patterns_established: []
+drill_down_paths: []
+observability_surfaces: []
+duration: ""
+verification_result: "Three verification checks passed: (1) git push exit code 0, (2) wiki page count API returns 20 (≥20), (3) Personality-Profiles page exists with 5459 chars containing 'extraction' content."
+completed_at: 2026-04-04T08:45:52.828Z
+blocker_discovered: false
+---
+
+# T01: Forgejo wiki updated with 9 files (1 new, 8 modified) covering M022 features: follow system, personality profiles, highlight v2, chat widget, multi-turn memory, creator tiers
+
+> Forgejo wiki updated with 9 files (1 new, 8 modified) covering M022 features: follow system, personality profiles, highlight v2, chat widget, multi-turn memory, creator tiers
+
+## What Happened
+---
+id: T01
+parent: S07
+milestone: M022
+key_files:
+  - Personality-Profiles.md
+  - Home.md
+  - Highlights.md
+  - Chat-Engine.md
+  - Data-Model.md
+  - API-Surface.md
+  - Frontend.md
+  - Decisions.md
+  - _Sidebar.md
+key_decisions:
+  - Grouped decisions by theme instead of flat table for readability at 40+ entries
+duration: ""
+verification_result: passed
+completed_at: 2026-04-04T08:45:52.828Z
+blocker_discovered: false
+---
+
+# T01: Forgejo wiki updated with 9 files (1 new, 8 modified) covering M022 features: follow system, personality profiles, highlight v2, chat widget, multi-turn memory, creator tiers
+
+**Forgejo wiki updated with 9 files (1 new, 8 modified) covering M022 features: follow system, personality profiles, highlight v2, chat widget, multi-turn memory, creator tiers**
+
+## What Happened
+
+Cloned Forgejo wiki via git on ub01, read all six S01-S06 slice summaries and DECISIONS.md for content. Created Personality-Profiles.md (new page covering extraction pipeline, JSONB schema, admin endpoint, frontend component). Updated Home.md (M022 features, quick links), Highlights.md (7→10 dimensions, creator endpoints, trim columns), Chat-Engine.md (multi-turn memory, ChatWidget), Data-Model.md (CreatorFollow, personality_profile, migrations), API-Surface.md (50→61 endpoints), Frontend.md (new components/pages/routes), Decisions.md (D036-D041), _Sidebar.md (Personality-Profiles link). Committed and pushed via HTTPS.
+
+## Verification
+
+Three verification checks passed: (1) git push exit code 0, (2) wiki page count API returns 20 (≥20), (3) Personality-Profiles page exists with 5459 chars containing 'extraction' content.
+
+## Verification Evidence
+
+| # | Command | Exit Code | Verdict | Duration |
+|---|---------|-----------|---------|----------|
+| 1 | `git push origin main` | 0 | ✅ pass | 3000ms |
+| 2 | `curl wiki/pages API + assert len>=20` | 0 | ✅ pass | 1000ms |
+| 3 | `curl wiki/page/Personality-Profiles + assert extraction` | 0 | ✅ pass | 1000ms |
+
+
+## Deviations
+
+Decisions page reorganized into themed sections for readability. Git credential helper configured for HTTPS push.
+
+## Known Issues
+
+None.
+
+## Files Created/Modified
+
+- `Personality-Profiles.md`
+- `Home.md`
+- `Highlights.md`
+- `Chat-Engine.md`
+- `Data-Model.md`
+- `API-Surface.md`
+- `Frontend.md`
+- `Decisions.md`
+- `_Sidebar.md`
+
+
+## Deviations
+Decisions page reorganized into themed sections for readability. Git credential helper configured for HTTPS push.
+
+## Known Issues
+None.