Phase 4: task-to-goal integration (Vision side)

Build the boundary the ImpactFlow core time-tracker plugs into. A task maps to
a foundation — one of the six stable profile elements (love, strength, mission,
vocation, short_term, long_term) — so the tracker can ask "which goal does this
build toward?" and post the answer back to Vision.

- Models + migration 006: task_mapping (one row per logged time entry).
- app/services/foundations.py: the six foundations + a pure, testable
  work-pattern aggregator (rollup) and a plain-language summary.
- app/routers/integration.py (user-scoped; tracker calls as the user or via
  X-API-Key): GET /foundations, POST/GET /task-mappings,
  GET /work-patterns?days=N (per-foundation minutes/share/neglected).
- Reminder engine now pulls from real work patterns: CheckinCoach takes an
  optional work-pattern summary (last 14 days) and reflects where time has gone
  against the person's own words — an observation, never a verdict.
- Frontend: dashboard.html (time per foundation + neglected); linked from
  profile.html.

Documented the core-tracker integration contract in the README. Phase 4
completes the Vision module's roadmap on the Discovery side; the core tracker
integrates by calling these endpoints.

Tests: 86 passing (added pure-aggregator, integration-endpoint, and
work-pattern-into-check-in tests; run in-container).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Joel Salmon
2026-06-16 21:24:58 -05:00
parent 50453901b3
commit c4fc1cccd7
16 changed files with 857 additions and 5 deletions
+44
View File
@@ -150,6 +150,50 @@ class RunCheckinsResponse(BaseModel):
generated: int
# -- Phase 4: task-to-goal integration ---------------------------------------
class FoundationOut(BaseModel):
key: str
label: str
text: Optional[str] = None
class TaskMappingCreate(BaseModel):
external_task_id: str
foundation: str
minutes: int = 0
task_label: str = ""
# When the work happened; defaults to now if omitted.
occurred_at: Optional[datetime] = None
class TaskMappingOut(BaseModel):
id: str
external_task_id: str
task_label: Optional[str] = None
foundation: str
minutes: int
occurred_at: datetime
created_at: datetime
class FoundationPattern(BaseModel):
foundation: str
label: str
minutes: int
task_count: int
last_at: Optional[datetime] = None
share: float
class WorkPatternsOut(BaseModel):
window_days: int
total_minutes: int
by_foundation: list[FoundationPattern]
neglected: list[str]
class ConversationResponse(BaseModel):
id: str
user_id: str