v2.4.0 — Insights 2.0

Insights 2.0 replaces the per-turn profile rewrite with a fact ledger and a profile rebuilt from it. A selfie life event can now carry her picture. Read the migration guides before upgrading: the stage-1 filter_prompt contract and the /svc/v1/insights/changes row shape both change.

• docs/migrating/v2-4-0-insights-2-0.md
• docs/migrating/v2-4-0-event-selfie-image.md

Features

• Insights 2.0: fact ledger and derived profile (#448). Stage 1 writes every fact into the new engine.human_facts ledger. Duplicates merge only on exact match, and roleplay is never merged with real-life facts. The human_insights profile is rebuilt from the ledger alone, through the new engine-owned profile_rebuild task, after 20 new facts or once a user has been idle for an hour (the idle case runs from a sweeper set with PROFILE_REBUILD_*). It no longer runs on every turn.
  • Seven profile columns are retired but left in the table: city, location, hometown, nationality, preferred_gender, age_min and age_max. Five are added: kinks, ideology, mental_health, education_level and education_status.
  • New service routes, each behind its own secret: GET /svc/v1/facts/changes, /svc/v1/facts/deletions, /svc/v1/insights/deletions, and POST /svc/v1/users/{user_id}/erase. The erase removes everything the engine derived about a user in one idempotent call.
  • Migration 0080 backfills the ledger from audit history and queues one rebuild per profile.
• A selfie that carries its picture, and an outfit on events (#445, #446). POST /v2/comp/session/{id}/events accepts image and outfit. A taking_selfie event returns an image_request when a composer is configured.

Docs

• New docs/insights.md (+ Chinese), the two migration guides, and a sweep of the API, model-config, audit and deployment docs (#449). The 1.x pipeline is described in docs/insights_legacy.md until v2.4.1.