claude-code-log 1.2.0__tar.gz → 1.3.0__tar.gz

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/.claude/skills/tool-renderer/SKILL.md

@@ -260,6 +260,32 @@ def title_WebSearchInput(self, input: WebSearchInput, message: TemplateMessage)
     return self._tool_title(message, "🔎", f'"{input.query}"')
 ```
 
+### Watch out: the template's wrench-suppression is emoji-range-gated
+
+Tool-use messages get a default `🛠️` prefix prepended by
+`templates/transcript.html` *unless* the title already starts with
+an emoji that `html/utils.py::starts_with_emoji` recognises. That
+function whitelists specific Unicode ranges:
+
+- `0x2300-0x23FF` Misc Technical (`⏰ ⏳ ⏱️ ⏲️ ⏸ ⏹ ⏺ ⏏` …)
+- `0x2600-0x26FF` Misc Symbols
+- `0x2700-0x27BF` Dingbats
+- `0x1F300-0x1F5FF` Misc Symbols and Pictographs
+- `0x1F600-0x1F64F` Emoticons
+- `0x1F680-0x1F6FF` Transport and Map Symbols
+- `0x1F900-0x1F9FF` Supplemental Symbols
+
+If the icon you pass to `_tool_title` falls **outside** these
+ranges, the template will helpfully add a `🛠️` in front of it,
+producing a redundant double-icon title like
+`🛠️ <your-icon> <ToolName>`. Verify by rendering a fixture and
+grepping for `🛠️` co-occurring with your icon, or by checking
+`ord(your_icon)` against the ranges above.
+
+If your icon is a real emoji that lives in a Unicode range not
+listed there, **add the range** to `starts_with_emoji` rather than
+picking a different icon.
+
 ## Step 5: Implement Markdown Renderer
 
 In `markdown/renderer.py`:
@@ -369,7 +395,7 @@ class Test{ToolName}OutputFormatting:
 uv run pytest test/test_{toolname}_rendering.py -v
 
 # Run full test suite to check for regressions
-uv run pytest -n auto -m "not (tui or browser)" -v
+uv run pytest -m "not (tui or browser)" -v
 ```
 
 ## Checklist

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/.github/workflows/ci.yml

@@ -33,13 +33,13 @@ jobs:
       run: uv sync --all-extras --dev && uv run playwright install chromium
 
     - name: Run unit tests with coverage
-      run: uv run pytest -n auto -m "not (tui or browser or benchmark)" --cov=claude_code_log --cov-report=xml --cov-report=html --cov-report=term
+      run: uv run pytest -m "not (tui or browser or benchmark)" --cov=claude_code_log --cov-report=xml --cov-report=html --cov-report=term
 
     - name: Run TUI tests with coverage append
-      run: uv run pytest -n auto -m tui --cov=claude_code_log --cov-append --cov-report=xml --cov-report=html --cov-report=term
+      run: uv run pytest -m tui --cov=claude_code_log --cov-append --cov-report=xml --cov-report=html --cov-report=term
 
     - name: Run browser tests with coverage append
-      run: uv run pytest -n auto -m browser --cov=claude_code_log --cov-append --cov-report=xml --cov-report=html --cov-report=term
+      run: uv run pytest -m browser --cov=claude_code_log --cov-append --cov-report=xml --cov-report=html --cov-report=term
 
     - name: Run benchmark tests with coverage append (primary only)
       if: matrix.is-primary

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/CHANGELOG.md

@@ -6,6 +6,39 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.3.0] - 2026-05-14
+
+### Changed
+
+- **Render ScheduleWakeup and Cron* tools (#148) (#152)**
+- **Render hook attachment entries at FULL detail (#128) (#149)**
+- **Style sidechain filter toggle with dashed border**
+- **scrub_surrogates: handle high surrogate range (CR follow-up) (#150)**
+- **Render the built-in Monitor tool with Task-end backlink (#142) (#147)**
+- **Add support for ai-title and prefer it over legacy summary (#136)**
+- **fix: add errors='replace' to read_text/write_text for Unicode safety (#139) (#146)**
+- **Fix UnicodeEncodeError on JSONL with lone surrogates (#139) (#144)**
+- **Use `--dist=worksteal` to speed up tests + move `-n auto` to config to make it default (#145)**
+- **Fix/prevent dag cycle (#138)**
+- **Render away_summary recap entries (#111) (#141)**
+- **System info cosmetic improvements + chain-pairing fix (#137) (#140)**
+- **dev-docs: introduce application_model.md as entry point, normalize naming, clean work/ (#134)**
+- **export conversations to json (#36)**
+- **Suppress noise in system-info messages (#129) (#133)**
+- **Fix DAG cyclic-children hang and add SIGUSR1 stack dump (#135)**
+- **Support async agents (#90) (#132)**
+- **Robust within-session fork rendering: collapse parallel-tool_use forks, consistent labels (#131)**
+- **Render user content as Markdown with raw fallback toggle (#119)**
+- **Add --detail user-only level (#118)**
+- **Pair Slash Command with User (slash command) (#126) (#127)**
+- **Fold Skill name into tool_use title and drop the params row**
+- **Fold Skill body into its tool_use block (#121)**
+- **docs: add Community Extensions section (#120)**
+- **Support teammates (#91): stitching + session headers + index (PR 3 of 3) (#125)**
+- **Support teammates (#91): rendering (PR 2 of 3) (#122)**
+- **Support teammates (#91): parsing + data model (draft) (#117)**
+
+
 ## [1.2.0] - 2026-04-19
 
 ### Changed

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/CLAUDE.md

@@ -51,26 +51,26 @@ See @CONTRIBUTING.md for detailed development setup, testing, architecture, and
 
 ### Claude-Specific Testing Tips
 
-**Always use `-n auto` for parallel test execution:**
+**Config in `pyproject.toml` sets `-n auto --dist=worksteal` so you might need to unset for pdb, etc**
 
 ```bash
 # Unit tests (fast, recommended for development)
 just test
-# or: uv run pytest -n auto -m "not (tui or browser)" -v
+# or: uv run pytest -m "not (tui or browser)" -v
 
 # TUI tests
 just test-tui
-# or: uv run pytest -n auto -m tui
+# or: uv run pytest -m tui
 
 # Browser tests
 just test-browser
-# or: uv run pytest -n auto -m browser
+# or: uv run pytest -m browser
 
 # All tests
 just test-all
 ```
 
-**Tip:** Add `-x` to stop on first failure (e.g., `uv run pytest -n auto -m "not (tui or browser)" -v -x`).
+**Tip:** Add `-x` to stop on first failure (e.g., `uv run pytest -m "not (tui or browser)" -v -x`).
 
 ### Code Quality
 
@@ -95,7 +95,30 @@ The interactive timeline is implemented in JavaScript within `claude_code_log/te
 
 ## Architecture
 
-For detailed architecture documentation, see:
+Start with [dev-docs/application_model.md](dev-docs/application_model.md)
+— the entry point covering subsystems, data lifecycle, and a glossary,
+with pointers to the deep-dive docs:
+
 - [dev-docs/rendering-architecture.md](dev-docs/rendering-architecture.md) - Data flow and rendering pipeline
 - [dev-docs/messages.md](dev-docs/messages.md) - Message type reference
 - [dev-docs/css-classes.md](dev-docs/css-classes.md) - CSS class combinations
+- [dev-docs/dag.md](dev-docs/dag.md) - DAG-based session/fork architecture
+- [dev-docs/agents.md](dev-docs/agents.md) - Sync/async/teammate agent integration
+- [dev-docs/teammates.md](dev-docs/teammates.md) - Teammates feature deep-dive
+- [dev-docs/message-hierarchy.md](dev-docs/message-hierarchy.md) - Fold/unfold state machine
+- [dev-docs/implementing-a-tool-renderer.md](dev-docs/implementing-a-tool-renderer.md) - How-to: add a new tool
+
+User-facing docs live in [docs/](docs/); plans and TODOs live in [work/](work/).
+
+### Keeping dev-docs/ in sync
+
+`dev-docs/` is **as-built reference** — the code is the authoritative
+source. When a non-trivial change alters behavior, structure, or
+invariants documented in a deep-dive, update the relevant page in
+the same commit (or as a prompt follow-up). If `dev-docs/` and the
+code disagree, the doc is wrong.
+
+Typical lifecycle: a feature begins as a spec in `work/`, evolves
+into a WIP scratchpad as the code adapts to reality, then graduates
+into `dev-docs/` (new page or merged into an existing one) once the
+implementation has stabilized.

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/CONTRIBUTING.md

@@ -50,7 +50,9 @@ claude_code_log/
 
 scripts/                # Development utilities
 test/test_data/         # Representative JSONL samples
-dev-docs/               # Architecture documentation
+dev-docs/               # Architecture / dev documentation (start in application_model.md)
+docs/                   # User-facing operations docs
+work/                   # Plans, TODOs, in-flight design docs
 ```
 
 ## Development Setup
@@ -94,7 +96,7 @@ The project uses a categorized test system to avoid async event loop conflicts.
 ```bash
 # Unit tests only (fast, recommended for development)
 just test
-# or: uv run pytest -n auto -m "not (tui or browser)" -v
+# or: uv run pytest -m "not (tui or browser)" -v
 
 # TUI tests (isolated event loop)
 just test-tui
@@ -114,16 +116,23 @@ just test-cov
 Snapshot tests detect unintended HTML output changes using [syrupy](https://github.com/syrupy-project/syrupy):
 
 ```bash
-# Run snapshot tests
-uv run pytest -n auto test/test_snapshot_html.py -v
+# Run snapshot tests (parallel mode is fine for read-only runs)
+uv run pytest test/test_snapshot_html.py -v
 
 # Update snapshots after intentional HTML changes
-uv run pytest -n auto test/test_snapshot_html.py --snapshot-update
+# IMPORTANT: run --snapshot-update with -n0 (see warning below)
+uv run pytest test/test_snapshot_html.py -n0 --snapshot-update
 ```
 
+> **Warning — don't let `--snapshot-update` run with `-n auto`.** Syrupy
+> and pytest-xdist race when writing snapshot files in parallel: the
+> `.ambr` file ends up truncated (observed: ~6000 lines silently
+> deleted on a single run, leaving the file structurally broken but
+> still passing on next read). Run `--snapshot-update` serially.
+
 When snapshot tests fail:
 1. Review the diff to verify changes are intentional
-2. If intentional, run `--snapshot-update` to accept new output
+2. If intentional, run `--snapshot-update` (serially) to accept new output
 3. If unintentional, fix your code and re-run tests
 
 ### Test Prerequisites
@@ -151,7 +160,7 @@ Running all tests together can cause "RuntimeError: This event loop is already r
 just test-cov
 
 # Or manually:
-uv run pytest -n auto --cov=claude_code_log --cov-report=html --cov-report=term
+uv run pytest --cov=claude_code_log --cov-report=html --cov-report=term
 ```
 
 HTML coverage reports are generated in `htmlcov/index.html`.
@@ -186,9 +195,23 @@ CLAUDE_CODE_LOG_DEBUG_TIMING=1 claude-code-log path/to/file.jsonl
 
 This outputs detailed timing for each rendering phase. The timing module is in `claude_code_log/renderer_timings.py`.
 
+## Diagnosing Hangs
+
+If `claude-code-log` appears stuck (100% CPU, no output), send `SIGUSR1` to print the live Python stack to stderr without killing the process:
+
+```bash
+# In another terminal
+kill -USR1 $(pgrep -f claude-code-log | head -1)
+```
+
+The handler is installed in `cli.py` via `faulthandler.register(SIGUSR1)`. POSIX-only; no-op on Windows. Unlike `py-spy`, it needs no root and no extra install.
+
 ## Architecture
 
-For detailed architecture documentation, see [dev-docs/rendering-architecture.md](dev-docs/rendering-architecture.md).
+Start with [dev-docs/application_model.md](dev-docs/application_model.md)
+for the system overview (subsystems, data lifecycle, glossary). For
+the rendering pipeline specifically, see
+[dev-docs/rendering-architecture.md](dev-docs/rendering-architecture.md).
 
 ### Data Flow Overview
 

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-log
-Version: 1.2.0
+Version: 1.3.0
 Summary: Convert Claude Code transcript JSONL files to HTML
 Project-URL: Homepage, https://github.com/daaain/claude-code-log
 Project-URL: Issues, https://github.com/daaain/claude-code-log/issues
@@ -66,7 +66,7 @@ uvx claude-code-log@latest --open-browser
 - **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
 - **System Command Visibility**: Show system commands (like `init`) in expandable details with structured parsing
 - **Markdown Rendering**: Server-side markdown rendering with syntax highlighting using mistune
-- **Detail Levels & Compact Mode**: `--detail full|high|low|minimal` filters by verbosity and `--compact` merges repeated section headings — pairs well with `--format md` to feed past conversations back to an LLM for analysis or experience building
+- **Detail Levels & Compact Mode**: `--detail full|high|low|minimal|user-only` filters by verbosity and `--compact` merges repeated section headings — pairs well with `--format md` to feed past conversations back to an LLM for analysis or experience building
 - **Floating Navigation**: Always-available back-to-top button and filter controls
 - **CLI Interface**: Simple command-line tool using Click
 
@@ -180,6 +180,7 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--detail` levels (smallest → largest output):
 
+- `user-only` — just user prompts and steering (useful as input to a downstream agent, e.g. building a requirements doc)
 - `minimal` — user + assistant text only
 - `low` — interaction-focused; keeps WebSearch, WebFetch, and Task (agent delegations) as key signals
 - `high` — detailed but cleaned; drops system/hook noise
@@ -280,6 +281,17 @@ uv run claude-code-log
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and architecture documentation.
 
+## Community Extensions
+
+Projects built on top of `claude-code-log`:
+
+- **[archive-session](https://github.com/lifeinchords/claude-code-skills#archive-session-skill--slash-command--optional-hook)** by [@lifeinchords](https://github.com/lifeinchords). Wraps the CLI as three integration surfaces:
+  - a Claude Code [Skill](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/skills/archive-session/SKILL.md)
+  - a Claude Code slash [Command](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/commands/archive-session.md) `/archive-session` for explicit in-chat invocation
+  - a Claude Code PreCompact [Hook](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/hooks/pre-compact-archive.sh) that auto-archives transcripts and subagent logs right before context compaction
+
+Cross-platform (macOS and Windows/MSYS).
+
 ## TODO
 
 - tutorial overlay

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/README.md

@@ -42,7 +42,7 @@ uvx claude-code-log@latest --open-browser
 - **Rich Message Types**: Support for user/assistant messages, tool use/results, thinking content, images
 - **System Command Visibility**: Show system commands (like `init`) in expandable details with structured parsing
 - **Markdown Rendering**: Server-side markdown rendering with syntax highlighting using mistune
-- **Detail Levels & Compact Mode**: `--detail full|high|low|minimal` filters by verbosity and `--compact` merges repeated section headings — pairs well with `--format md` to feed past conversations back to an LLM for analysis or experience building
+- **Detail Levels & Compact Mode**: `--detail full|high|low|minimal|user-only` filters by verbosity and `--compact` merges repeated section headings — pairs well with `--format md` to feed past conversations back to an LLM for analysis or experience building
 - **Floating Navigation**: Always-available back-to-top button and filter controls
 - **CLI Interface**: Simple command-line tool using Click
 
@@ -156,6 +156,7 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--detail` levels (smallest → largest output):
 
+- `user-only` — just user prompts and steering (useful as input to a downstream agent, e.g. building a requirements doc)
 - `minimal` — user + assistant text only
 - `low` — interaction-focused; keeps WebSearch, WebFetch, and Task (agent delegations) as key signals
 - `high` — detailed but cleaned; drops system/hook noise
@@ -256,6 +257,17 @@ uv run claude-code-log
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and architecture documentation.
 
+## Community Extensions
+
+Projects built on top of `claude-code-log`:
+
+- **[archive-session](https://github.com/lifeinchords/claude-code-skills#archive-session-skill--slash-command--optional-hook)** by [@lifeinchords](https://github.com/lifeinchords). Wraps the CLI as three integration surfaces:
+  - a Claude Code [Skill](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/skills/archive-session/SKILL.md)
+  - a Claude Code slash [Command](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/commands/archive-session.md) `/archive-session` for explicit in-chat invocation
+  - a Claude Code PreCompact [Hook](https://github.com/lifeinchords/claude-code-skills/blob/main/.claude/hooks/pre-compact-archive.sh) that auto-archives transcripts and subagent logs right before context compaction
+
+Cross-platform (macOS and Windows/MSYS).
+
 ## TODO
 
 - tutorial overlay

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/claude_code_log/cache.py

@@ -47,6 +47,10 @@ class SessionCacheData(BaseModel):
 
     session_id: str
     summary: Optional[str] = None
+    # Claude Code's AI-generated short session title, sourced from
+    # `ai-title` JSONL entries (last one wins). Preferred over `summary`
+    # for display when present.
+    ai_title: Optional[str] = None
     first_timestamp: str
     last_timestamp: str
     message_count: int
@@ -56,6 +60,9 @@ class SessionCacheData(BaseModel):
     total_output_tokens: int = 0
     total_cache_creation_tokens: int = 0
     total_cache_read_tokens: int = 0
+    # Teammates feature — set when the session was active in a team.
+    # First non-None ``teamName`` of any entry in the session.
+    team_name: Optional[str] = None
 
 
 class HtmlCacheEntry(BaseModel):
@@ -122,6 +129,48 @@ class ProjectCache(BaseModel):
 # ========== Helper Functions ==========
 
 
+# Lone HIGH surrogates (U+D800–U+DBFF) are not in surrogateescape's
+# back-mapping range (which only covers low surrogates U+DC80–U+DCFF
+# produced from raw byte decoding), so the surrogateescape-encode step
+# in scrub_surrogates would raise on them. Pre-substitute high
+# surrogates directly with U+FFFD before the encode step.
+_HIGH_SURROGATE_RE = re.compile(r"[\ud800-\udbff]")
+
+
+def scrub_surrogates(s: Optional[str]) -> Optional[str]:
+    """Replace lone surrogates (U+D800…U+DFFF) with U+FFFD.
+
+    Public helper used wherever ``surrogateescape``-decoded JSONL data
+    might cross a strict-UTF-8 boundary (issue #139). Examples:
+    sqlite3's text-binding path (``cache.update_session_cache``) and
+    TUI export (``tui.SessionBrowser._ensure_session_file``) — both
+    raise ``UnicodeEncodeError`` on lone surrogates the moment we try
+    to persist them.
+
+    Two ranges to handle, with two different mechanisms:
+
+    - **Low surrogates** (U+DC80…U+DCFF) — what ``surrogateescape``
+      uses when decoding raw bytes. ``encode("utf-8",
+      errors="surrogateescape")`` reverses the mapping back to the
+      original raw byte (``\\udcb2`` → ``b"\\xb2"``); the subsequent
+      ``decode("utf-8", errors="replace")`` then substitutes those
+      invalid bytes with U+FFFD on the decode side.
+    - **High surrogates** (U+D800…U+DBFF) — ``surrogateescape`` has
+      no mapping for these (they're not produced by raw-byte decoding),
+      so the encode step would raise ``UnicodeEncodeError``. Pre-scrub
+      them directly via regex substitution before the encode step.
+
+    Why not the simpler ``encode(..., errors="replace")``? That emits
+    ASCII ``?`` (U+003F) on encode rather than the canonical Unicode
+    replacement U+FFFD on decode — also valid UTF-8, but a less
+    informative sentinel.
+    """
+    if s is None:
+        return None
+    s = _HIGH_SURROGATE_RE.sub("�", s)
+    return s.encode("utf-8", errors="surrogateescape").decode("utf-8", errors="replace")
+
+
 def get_library_version() -> str:
     """Get the current library version from package metadata or pyproject.toml."""
     # First try to get version from installed package metadata
@@ -597,8 +646,9 @@ class CacheManager:
                         project_id, session_id, summary, first_timestamp, last_timestamp,
                         message_count, first_user_message, cwd,
                         total_input_tokens, total_output_tokens,
-                        total_cache_creation_tokens, total_cache_read_tokens
-                    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+                        total_cache_creation_tokens, total_cache_read_tokens,
+                        team_name, ai_title
+                    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
                     ON CONFLICT(project_id, session_id) DO UPDATE SET
                         summary = excluded.summary,
                         first_timestamp = excluded.first_timestamp,
@@ -609,21 +659,29 @@ class CacheManager:
                         total_input_tokens = excluded.total_input_tokens,
                         total_output_tokens = excluded.total_output_tokens,
                         total_cache_creation_tokens = excluded.total_cache_creation_tokens,
-                        total_cache_read_tokens = excluded.total_cache_read_tokens
+                        total_cache_read_tokens = excluded.total_cache_read_tokens,
+                        team_name = excluded.team_name,
+                        ai_title = excluded.ai_title
                     """,
                     (
                         self._project_id,
                         session_id,
-                        data.summary,
+                        # Scrub surrogate-bearing strings before binding —
+                        # sqlite3 raises UnicodeEncodeError on lone
+                        # surrogates that surrogateescape-decoded JSONL
+                        # may have leaked into these text fields. (#139)
+                        scrub_surrogates(data.summary),
                         data.first_timestamp,
                         data.last_timestamp,
                         data.message_count,
-                        data.first_user_message,
-                        data.cwd,
+                        scrub_surrogates(data.first_user_message),
+                        scrub_surrogates(data.cwd),
                         data.total_input_tokens,
                         data.total_output_tokens,
                         data.total_cache_creation_tokens,
                         data.total_cache_read_tokens,
+                        scrub_surrogates(data.team_name),
+                        scrub_surrogates(data.ai_title),
                     ),
                 )
 
@@ -742,6 +800,7 @@ class CacheManager:
                 sessions[row["session_id"]] = SessionCacheData(
                     session_id=row["session_id"],
                     summary=row["summary"],
+                    ai_title=row["ai_title"] if "ai_title" in row.keys() else None,
                     first_timestamp=row["first_timestamp"],
                     last_timestamp=row["last_timestamp"],
                     message_count=row["message_count"],
@@ -751,6 +810,7 @@ class CacheManager:
                     total_output_tokens=row["total_output_tokens"],
                     total_cache_creation_tokens=row["total_cache_creation_tokens"],
                     total_cache_read_tokens=row["total_cache_read_tokens"],
+                    team_name=row["team_name"] if "team_name" in row.keys() else None,
                 )
 
         return ProjectCache(
@@ -790,6 +850,11 @@ class CacheManager:
             # 0.9.0 introduced _compact_ide_tags_for_preview() which transforms
             # first_user_message to use emoji indicators instead of raw IDE tags
             "0.8.0": "0.9.0",
+            # 1.3.0 added handling for `ai-title` JSONL entries: existing
+            # caches have a NULL `ai_title` column for every session until
+            # JSONLs are re-ingested, so the project index keeps showing
+            # the old session-id title until the cache is rebuilt.
+            "1.2.0": "1.3.0",
         }
 
         cache_ver = version.parse(cache_version)
@@ -1059,6 +1124,7 @@ class CacheManager:
                     archived_sessions[session_id] = SessionCacheData(
                         session_id=session_id,
                         summary=row["summary"],
+                        ai_title=row["ai_title"] if "ai_title" in row.keys() else None,
                         first_timestamp=row["first_timestamp"],
                         last_timestamp=row["last_timestamp"],
                         message_count=row["message_count"],
@@ -1068,6 +1134,9 @@ class CacheManager:
                         total_output_tokens=row["total_output_tokens"],
                         total_cache_creation_tokens=row["total_cache_creation_tokens"],
                         total_cache_read_tokens=row["total_cache_read_tokens"],
+                        team_name=row["team_name"]
+                        if "team_name" in row.keys()
+                        else None,
                     )
 
         return archived_sessions

{claude_code_log-1.2.0 → claude_code_log-1.3.0}/claude_code_log/cli.py

@@ -1,8 +1,10 @@
 #!/usr/bin/env python3
 """CLI interface for claude-code-log."""
 
+import faulthandler
 import logging
 import os
+import signal
 import sys
 from pathlib import Path
 from typing import Optional
@@ -16,6 +18,7 @@ from .converter import (
     ensure_fresh_cache,
     generate_single_session_file,
     get_file_extension,
+    get_index_filename,
     process_projects_hierarchy,
 )
 from .cache import (
@@ -27,6 +30,25 @@ from .cache import (
 )
 
 
+def _install_stack_dump_signal() -> None:
+    """Make ``kill -USR1 <pid>`` print the live Python stack to stderr.
+
+    Useful for diagnosing apparent hangs without killing the process —
+    py-spy needs root on macOS, but this only needs the signal. SIGUSR1
+    is POSIX-only; on Windows we silently skip.
+    """
+    sigusr1 = getattr(signal, "SIGUSR1", None)
+    if sigusr1 is None:
+        return
+    try:
+        faulthandler.register(sigusr1, all_threads=True, chain=False)
+    except (RuntimeError, ValueError, OSError):
+        # E.g. signal already taken, no-tty environments, or platforms
+        # where faulthandler.register raises. Diagnostics shouldn't
+        # break the CLI — silently skip.
+        pass
+
+
 def get_default_projects_dir() -> Path:
     """Get the default Claude projects directory path."""
     return Path.home() / ".claude" / "projects"
@@ -360,8 +382,25 @@ def _clear_caches(input_path: Path, all_projects: bool) -> None:
         click.echo(f"Warning: Failed to clear cache: {e}")
 
 
-def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) -> None:
-    """Clear generated output files (HTML or Markdown) for the specified path."""
+def _list_generated_outputs(directory: Path, file_ext: str) -> list[Path]:
+    """Return only files this tool generates, not every file with the extension.
+
+    Safe for JSON in particular, where the project directory may contain
+    unrelated user `.json` files that must not be deleted.
+    """
+    if file_ext == "json":
+        return [
+            *directory.glob("combined_transcripts*.json"),
+            *directory.glob("session-*.json"),
+        ]
+    return list(directory.glob(f"*.{file_ext}"))
+
+
+def _clear_output_files(
+    input_path: Path, all_projects: bool, output_format: str
+) -> None:
+    """Clear generated output files (HTML/Markdown/JSON) for the specified path."""
+    file_ext = get_file_extension(output_format)
     ext_upper = file_ext.upper()
     try:
         if all_projects:
@@ -377,7 +416,7 @@ def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) ->
             for project_dir in project_dirs:
                 try:
                     # Remove output files in project directory
-                    output_files = list(project_dir.glob(f"*.{file_ext}"))
+                    output_files = _list_generated_outputs(project_dir, file_ext)
                     for output_file in output_files:
                         output_file.unlink()
                         total_removed += 1
@@ -391,12 +430,14 @@ def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) ->
                         f"  Warning: Failed to clear {ext_upper} files for {project_dir.name}: {e}"
                     )
 
-            # Also remove top-level index file
-            index_file = input_path / f"index.{file_ext}"
+            # Also remove top-level index file (shared helper keeps this in
+            # sync with the generator, which uses a different name for JSON).
+            index_filename = get_index_filename(output_format)
+            index_file = input_path / index_filename
             if index_file.exists():
                 index_file.unlink()
                 total_removed += 1
-                click.echo(f"  Removed top-level index.{file_ext}")
+                click.echo(f"  Removed top-level {index_filename}")
 
             if total_removed > 0:
                 click.echo(f"Total: Removed {total_removed} {ext_upper} files")
@@ -406,7 +447,7 @@ def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) ->
         elif input_path.is_dir():
             # Clear output files for single directory
             click.echo(f"Clearing {ext_upper} files for {input_path}...")
-            output_files = list(input_path.glob(f"*.{file_ext}"))
+            output_files = _list_generated_outputs(input_path, file_ext)
             for output_file in output_files:
                 output_file.unlink()
 
@@ -492,9 +533,9 @@ def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) ->
     "-f",
     "--format",
     "output_format",
-    type=click.Choice(["html", "md", "markdown"]),
+    type=click.Choice(["html", "md", "markdown", "json"]),
     default="html",
-    help="Output format (default: html). Supports html, md, or markdown.",
+    help="Output format (default: html). Supports html, md/markdown, or json.",
 )
 @click.option(
     "--image-export-mode",
@@ -515,14 +556,18 @@ def _clear_output_files(input_path: Path, all_projects: bool, file_ext: str) ->
 )
 @click.option(
     "--detail",
-    type=click.Choice(["full", "high", "low", "minimal"], case_sensitive=False),
+    type=click.Choice(
+        ["full", "high", "low", "minimal", "user-only"], case_sensitive=False
+    ),
     default="full",
     help=(
         "Detail level for output. "
         "full: everything; "
         "high: detailed but cleaned (no system/hook noise); "
         "low: interaction-focused + key signals; "
-        "minimal: user + assistant messages only."
+        "minimal: user + assistant messages only; "
+        "user-only: only user prompts and steering (for feeding to "
+        "downstream agents, e.g. building a requirements doc)."
     ),
 )
 @click.option(
@@ -564,6 +609,10 @@ def main(
 
     INPUT_PATH: Path to a Claude transcript JSONL file, directory containing JSONL files, or project path to convert. If not provided, defaults to ~/.claude/projects/ and --all-projects is used.
     """
+    # Install signal-based stack dumper before any heavy work, so a hang
+    # can be diagnosed with `kill -USR1 <pid>` without root or restart.
+    _install_stack_dump_signal()
+
     # Configure logging to show warnings and above
     logging.basicConfig(level=logging.WARNING, format="%(levelname)s: %(message)s")
 
@@ -751,10 +800,10 @@ def main(
 
         # Handle output files clearing
         if clear_output:
-            file_ext = get_file_extension(output_format)
-            _clear_output_files(input_path, all_projects, file_ext)
+            _clear_output_files(input_path, all_projects, output_format)
             if clear_output and not (from_date or to_date or input_path.is_file()):
                 # If only clearing output files, exit after clearing
+                file_ext = get_file_extension(output_format)
                 click.echo(f"{file_ext.upper()} files cleared successfully.")
                 return