pi-lesson-extractor

A pi extension that automatically extracts reusable problem-solving patterns from session transcripts.

What it does

Runs pattern detection on session shutdown and session switch (/new), extracting:

1. Retry loop detection — same tool fails then succeeds with a different approach
2. Error→fix pair detection — error messages mapped to their resolutions
3. User correction detection — user messages that corrected agent behavior
4. Confirmation detection — user messages that validated an approach (positive signal)

Candidates accumulate with confidence scores and auto-promote to permanent pi-memory lessons when they reach threshold.

Installation

pi install @samfp/pi-lesson-extractor

Requires @samfp/pi-memory as a peer dependency (for lesson promotion).

How it works

Lifecycle

• session_before_switch — runs fast heuristic pattern detection on current session entries before /new or /resume
• session_shutdown — same extraction on process exit
• session_start — checks for pending candidates, runs auto-promotion pipeline, shows notification count

Auto-promotion pipeline

Candidates that meet promotion criteria (high confidence, seen across multiple sessions) are automatically promoted to permanent pi-memory lessons on the next session start.

Tools

Tool	Description
lesson_candidates	List pending lesson candidates by status
lesson_accept	Promote a candidate to a permanent lesson
lesson_reject	Reject a candidate permanently

Commands

Command	Description
/lessons-review	Interactive review of pending candidates

Storage

Candidates are stored in a SQLite database at ~/.pi/agent/lesson-extractor/candidates.db.

License

MIT