Skip to content

fix(sensor): preserve Claude transcript content and incremental updates #130

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
barisozbas wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix(sensor): preserve Claude transcript content and incremental updates #130

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions Sensor/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,32 @@ ADR Sensor is a Python library that collects telemetry from AI coding agents to
| **opencode** | `opencode` | SQLite (`opencode.db`) or JSON tree | macOS, Linux |
| **Gemini CLI** | `gemini` | JSONL journals + legacy JSON chats | macOS, Linux, Windows |

### Claude Code

The `claude` source reads transcripts recursively under `~/.claude/projects/`,
including [subagent transcripts](https://code.claude.com/docs/en/sub-agents#resume-subagents)
under `<project>/<sessionId>/subagents/agent-<agentId>.jsonl` and nested workflow
directories. Main sessions keep the `claude_<sessionId>` identity; subagents use
`claude_<sessionId>_agent_<agentId>` and include `parent_session_id` and `agent_id`
in `session_context` so their exports do not overwrite the parent conversation.

String and text-block messages are retained, including user text accompanying
tool results. Results are matched by tool-call ID. Malformed records are skipped
without discarding surrounding messages. Complete JSON objects concatenated on
one physical line and NUL padding between objects are accepted; incomplete tails
are skipped without joining physical lines or repairing text inside a message.

Each event includes `raw_log_path`, a stable conversation-start `timestamp`, and
`session_context.last_event_at` and `event_count` for incremental updates. A file
without any valid timestamp uses its modification time. `--save-sessions` updates
the saved snapshot when a tool completes or a conversation resumes, even within
the same timestamp second. All recorded branches are retained in file order.

The default lookback is 14 days by file modification time. Existing limits still
apply: top-level tool argument strings and tool results are truncated at 1,000
characters; non-text content blocks and separately spilled tool-output files are
not imported. Contract tests use synthetic transcripts and do not launch Claude.

### Claude Desktop Agent Mode

The `claude_desktop` source covers Claude Desktop's local agent mode (released as
Expand Down
2 changes: 1 addition & 1 deletion Sensor/adr_sensor/observer.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ class AgentObserver:
"claude_desktop": ("Darwin", "Windows"),
}

CONTENT_AWARE_INCREMENTAL_SOURCES = frozenset({"codex", "copilot", "dsh", "gemini"})
CONTENT_AWARE_INCREMENTAL_SOURCES = frozenset({"claude", "codex", "copilot", "dsh", "gemini"})

def __init__(self, output_dir: Optional[Path] = None, max_age_days: Optional[int] = None):
"""Initialize the AgentObserver.
Expand Down
Loading
Loading