name: episode-complete
description: Complete and score a learning episode to extract patterns and update heuristics. Use when finalizing a task to enable pattern extraction and future learning.

Episode Complete

Complete and score a learning episode to extract patterns and update heuristics.

Purpose

Finalize an episode with outcome scoring, reflection generation, and pattern extraction for future retrieval.

Steps

1. Gather outcome data:
2. Final verdict (success, partial_success, failure)
3. Total time spent
4. Total tokens used (if applicable)
5. Key artifacts produced

6. Errors encountered

7. Create TaskOutcome:
   rust let outcome = TaskOutcome { verdict: Verdict::Success, time_ms: total_time, tokens: total_tokens, artifacts: vec![/* paths to created/modified files */], errors: vec![/* any errors encountered */], };

8. Call complete_episode:
   rust memory.complete_episode(episode_id, outcome).await?;

9. System processes:

10. Computes RewardScore based on:
    • Success/failure
    • Time efficiency
    • Code quality
11. Generates Reflection:
    • What worked well
    • What could be improved
    • Key learnings

12. Extracts Patterns:

    • Tool sequences
    • Decision points
    • Common pitfalls

13. Update storage:

14. Store in Turso (permanent record)
15. Update redb cache
16. Index by task_type and timestamp

17. Update related patterns and heuristics

18. Validation:

19. Verify episode was scored
20. Check patterns were extracted
21. Ensure heuristics were updated

Pattern Types Extracted

• ToolSequence: Common tool usage patterns
• DecisionPoint: Key decision moments and outcomes
• ErrorPattern: Common errors and resolutions
• PerformancePattern: Optimization opportunities

Scoring Rubric

• Success: Task completed, tests pass, meets requirements
• Partial Success: Task mostly complete, minor issues
• Failure: Task incomplete, major issues, tests failing

Example

let outcome = TaskOutcome {
    verdict: Verdict::Success,
    time_ms: 45000,
    tokens: 12000,
    artifacts: vec![
        "src/storage/batch.rs".to_string(),
        "tests/integration/batch_test.rs".to_string(),
    ],
    errors: vec![],
};

memory.complete_episode(episode_id, outcome).await?;

Post-Completion

• Patterns are now available for future retrieval
• Heuristics updated for similar tasks
• Episode stored for long-term learning
• Embeddings computed (if service configured)