cjm-harness-transcripts

Harness-transcript extraction library: reads Claude Code session transcripts (JSONL DAGs), walks the active path, and extracts the user-facing prose — assistant markdown bodies, cleaned user prompts, and curated tool-parameter prose (e.g. SendUserFile captions) — as ExtractedMessages ready to mint onto a context-graph session spine.

Modules

• cjm_harness_transcripts — cjm-harness-transcripts: parse agent-harness session transcripts (Claude Code
• cjm_harness_transcripts.extract — User-facing prose extraction — both sides, one truth.
• cjm_harness_transcripts.mapping — Transcript ↔ session-key mapping, derived at pull time.
• cjm_harness_transcripts.records — The transcript record layer: tolerant JSONL loading + the append-only DAG.

API

cjm_harness_transcripts.extract

• ExtractedMessage class — One user-facing message off the active path, ready to become a Message node.
• clean_user_text function — Strip harness wrapper blocks from a user prompt; collapse the scar tissue.
• extract_messages function — The active path's user-facing messages, chronological.

cjm_harness_transcripts.mapping

• BootInfo class — The first user prose of a transcript — the mapping's evidence.
• TranscriptMatch class — One ranked candidate pairing for a session key.
• find_transcripts_for_key function — All plausible transcripts for a session key, best first.
• parse_record_timestamp function — A transcript record timestamp (ISO-8601, trailing Z) as an aware datetime.
• parse_session_key function — A session key (local start timestamp, e.g. 2026-08-20_17-05-20) as an aware datetime.
• read_boot_info function — The transcript's first user record bearing prose, or None (empty/tool-only file).

cjm_harness_transcripts.records

• TranscriptDag class — The uuid-addressable view of a transcript: parent edges, forks, active path.
• TranscriptRecord class — One JSONL record, uuid-addressable or not, with the raw dict preserved.
• load_records function — Load a transcript JSONL tolerantly, in file order.

Dependencies

Used by: cjm-context-graph-projection