session-report

Session Report

Generate a structured performance report for a distilled clens session.

Variables

TARGET: $ARGUMENTS

Instructions

1. Resolve the Session

• If TARGET is empty or --last, find the most recent distilled session:
  • List files in .clens/distilled/ sorted by modification time
  • Use the most recently modified .json file
• If TARGET is a session ID (full UUID or prefix), find .clens/distilled/{TARGET}*.json
• If no distilled file is found, tell the user:

  No distilled session found. Run clens distill --last to distill your most recent session, then re-run this command.

2. Read the Data

• Read the distilled JSON file at .clens/distilled/{sessionId}.json
• Parse the full DistilledSession object
• Load the session-analysis skill for schema and interpretation context

3. Generate the Report

Use the following template. Replace all placeholders with actual data. Omit sections that have no data (e.g., skip Backtracks section if array is empty, skip Agents section if not a multi-agent session).

---

Session Report: {session_id first 8 chars}

Overview

Metric	Value
Duration	{summary.key_metrics.duration_human}
Model	{stats.model or "unknown"}
Tool calls	{stats.tool_call_count}
Failures	{stats.failure_count} ({failure_rate as percentage}%)
Files touched	{stats.unique_files.length}
Files modified	{summary.key_metrics.files_modified}
Estimated cost	${stats.cost_estimate.estimated_cost_usd}
Backtracks	{backtracks.length}
Thinking blocks	{reasoning.length}

Narrative

{summary.narrative}

Efficiency Score

Calculate a score from 1-10 based on these weighted factors:

• Failure rate (weight 3): 10 if <5%, 7 if 5-15%, 4 if 15-30%, 1 if >30%
• Backtrack density (weight 3): 10 if 0, 8 if 1-2, 5 if 3-4, 2 if 5+
• Cost efficiency (weight 2): 10 if cost/file < $0.50, 7 if < $1.00, 4 if < $2.00, 1 if > $2.00
• Phase coherence (weight 2): 10 if clear progression, 5 if some back-and-forth, 2 if chaotic