#1 feat: signal-based profile refactor — modular extraction, merge, and rendering

[Anonymous]

Originally created by: TheoV823

Summary

• New app/profiles/ package with four single-responsibility modules: signals.py, extractors.py, builder.py, renderer.py
• Deterministic merge layer (build_mneme_profile): QA signals dominate; extra-context can only confirm or extend; confidence levels are low / medium / high only — no floats, no blending
• Structured profile format: every field carries {value, confidence, sources} — replaces raw JSON blob injection
• Clean prompt injection: structured profiles render as readable decision-maker text; legacy profiles keep the existing <user_profile> XML wrapper for backward compatibility
• assemble_mneme() signature unchanged — engine.py untouched
• add-user gains --extra-context-path for optional free-text signal input via a synchronous Claude API call
• Migration script (migrate_add_extra_context.sql) for existing databases; one nullable extra_context TEXT column added to users
• 78 tests across four new test files covering all extraction, merge, render, and assembly paths

Architecture

```
JSON profile → extract_qa_signals()
↘
build_mneme_profile() → render_profile_for_prompt() → Claude
↗
free text → extract_extra_context_signals() (optional)
```

Test Plan

• [x] 78/78 tests passing on branch
• [x] `tests/test_signal_extractors.py` — extraction paths, legacy adapter, EC extractor (mocked)
• [x] `tests/test_profile_builder.py` — all merge scenarios (QA-only, agreement, conflict, EC-only, list dedup)
• [x] `tests/test_profile_renderer.py` — structured render, legacy normalization, empty field omission
• [x] `tests/test_prompt_assembly.py` — structured no XML, legacy keeps XML, backward compat
• [x] Run `python -m pytest tests/ -q` to verify

Migration

For any database created before 2026-04-07, run once:
```sql
ALTER TABLE users ADD COLUMN extra_context TEXT;
```
No data migration needed — existing `mneme_profile` values handled by legacy compat path.

---

🤖 Generated with Claude Code

[Anonymous]

Ticket changed by: TheoV823

• status: open --> closed