Files
impactflow_discovery/app/schemas.py
T
Joel Salmon b4d8d17aed Phase 2: AI coach reflection loop
Add the mirror-not-compass reflection layer between profile generation and
affirmation. The coach reflects the person's profile back, and only when they
explicitly correct or add something does it propose revisions in their own
direction — never prescribing goals.

- ReflectionCoach service (app/services/reflector.py): Anthropic-backed,
  returns {message, revisions, revision_note}; revisions filtered to the seven
  editable prose fields (never triad/type); one-retry JSON handling.
- Endpoints (owner-scoped, 409 when locked): POST /discovery/profile/me/reflect
  (opener + turns, applies revisions), GET .../reflection (dialogue),
  GET .../revisions (iteration history). complete records an 'extraction'
  revision; PATCH records 'manual_edit'.
- Models + migration 004: reflection_message (coach/person turns) and
  profile_revision (snapshots: extraction | reflection | manual_edit) —
  captures edits and iterations rather than overwriting.
- Frontend: reflect.html chat (coach/person bubbles, live profile summary that
  refreshes on revision, affirm); linked from profile.html.
- Affirmation remains the existing confirm/lock.

Also refresh README for Phase 2 and for the HTTPS deployment
(https://impactflow.teamci.org:8011, OAUTH_REDIRECT_URI + COOKIE_SECURE notes).

Tests: 50 passing (added reflector unit tests and reflection endpoint tests;
run in-container).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 20:58:45 -05:00

125 lines
3.3 KiB
Python

"""Pydantic request/response models for the discovery API."""
from datetime import datetime
from typing import Optional
from pydantic import BaseModel
class StartResponse(BaseModel):
conversation_id: str
class RespondRequest(BaseModel):
prompt_alive: str = ""
prompt_friction: str = ""
prompt_pull: str = ""
prompt_recognition: str = ""
prompt_future: str = ""
prompt_goals_short: str = ""
prompt_goals_long: str = ""
class RespondResponse(BaseModel):
conversation_id: str
status: str
class Confidence(BaseModel):
triad: Optional[str] = None
type: Optional[str] = None
variant: Optional[str] = None
ikigai: Optional[str] = None
class ProfileResponse(BaseModel):
id: str
user_id: str
conversation_id: str
generated_at: datetime
triad: Optional[str] = None
probable_type: Optional[int] = None
wing: Optional[int] = None
instinctual_variant: Optional[str] = None
instinctual_stack: Optional[str] = None
love_summary: Optional[str] = None
strength_summary: Optional[str] = None
mission_summary: Optional[str] = None
vocation_summary: Optional[str] = None
overlap_narrative: Optional[str] = None
short_term_goals: Optional[str] = None
long_term_goals: Optional[str] = None
confidence: Optional[Confidence] = None
locked: bool = False
extraction_notes: Optional[str] = None
class ProfileUpdate(BaseModel):
"""Partial edit of a profile's prose. Only fields explicitly provided are
updated (see exclude_unset in the router). The AI's structural inference
(triad/type/wing/variant) and confidence are not editable here."""
love_summary: Optional[str] = None
strength_summary: Optional[str] = None
mission_summary: Optional[str] = None
vocation_summary: Optional[str] = None
overlap_narrative: Optional[str] = None
short_term_goals: Optional[str] = None
long_term_goals: Optional[str] = None
class ConfirmResponse(BaseModel):
status: str
# -- Phase 2: AI coach reflection loop ---------------------------------------
class ReflectRequest(BaseModel):
# Empty/omitted starts the loop (the coach's opening reflection).
message: str = ""
class ReflectionMessageOut(BaseModel):
role: str # "coach" or "person"
content: str
sequence: int
created_at: datetime
class ReflectTurnResponse(BaseModel):
"""One coach turn, plus the (possibly revised) profile."""
message: ReflectionMessageOut
profile: ProfileResponse
revised: bool = False
revision_note: Optional[str] = None
class ReflectionThreadResponse(BaseModel):
messages: list[ReflectionMessageOut]
profile: ProfileResponse
class ProfileRevisionOut(BaseModel):
id: str
source: str # "extraction" | "reflection" | "manual_edit"
fields: dict
note: Optional[str] = None
created_at: datetime
class ConversationResponse(BaseModel):
id: str
user_id: str
started_at: datetime
completed_at: Optional[datetime] = None
prompt_alive: Optional[str] = None
prompt_friction: Optional[str] = None
prompt_pull: Optional[str] = None
prompt_recognition: Optional[str] = None
prompt_future: Optional[str] = None
prompt_goals_short: Optional[str] = None
prompt_goals_long: Optional[str] = None
model_config = {"from_attributes": True}