./mkdocs.yml
./LICENSE
./justfile
./uv.lock
./CHANGELOG.md
./pyproject.toml
./.editorconfig
./README.md
./mise.toml
./.gitignore
./CONTRIBUTING.md
./CLAUDE.md
./stubs/quickjs.pyi
./test/test_renderer.py
./test/test_normalized_renderer.py
./test/test_ai_title.py
./test/test_steering_queued_command.py
./test/snapshot_serializers.py
./test/test_cache_integration.py
./test/test_codex_detection.py
./test/test_codex_tools.py
./test/test_xss_titles.py
./test/test_nested_dom_browser.py
./test/test_date_filtering.py
./test/test_markdown_rendering.py
./test/test_utils.py
./test/test_fork_invisible_node.py
./test/test_xss_browser.py
./test/test_depth_levels.py
./test/test_pagination.py
./test/conftest.py
./test/test_surrogate_encoding.py
./test/test_dag.py
./test/test_message_filtering.py
./test/test_codex_decode_once.py
./test/test_read_tool_pygments.py
./test/test_teammates_parsing.py
./test/test_codex_list_agents.py
./test/test_codex_quickjs_adversarial.py
./test/test_combined_transcript_link.py
./test/test_commit_linkifier.py
./test/test_tool_result_image_rendering.py
./test/test_slash_command_pairing.py
./test/test_output_paths.py
./test/test_toggle_functionality.py
./test/test_taskstop_rendering.py
./test/test_integration_realistic.py
./test/test_codex_wholesale.py
./test/test_codex_fork_prefix_decodes.py
./test/test_codex_user_shell.py
./test/test_steering_ordering_composition.py
./test/test_obsidian_output.py
./test/test_path_projection.py
./test/test_timeline_browser.py
./test/test_codex_web_open.py
./test/test_context_command.py
./test/test_command_handling.py
./test/test_project_matching.py
./test/test_async_agents.py
./test/test_codex_images.py
./test/test_cross_provider_tool_results.py
./test/test_ghost_repair.py
./test/test_askuserquestion_rendering.py
./test/test_grep_rendering.py
./test/test_markdown_timestamps.py
./test/test_branch_label_source.py
./test/test_codex_messages.py
./test/test_silent_skip.py
./test/test_output_stdout.py
./test/__init__.py
./test/test_project_display_name.py
./test/test_json_real_projects.py
./test/test_version_deduplication.py
./test/test_cache_all_formats.py
./test/test_migrations.py
./test/test_params_table_hybrid.py
./test/test_generic_tool_result.py
./test/test_workflow_parsing.py
./test/test_renderer_timings.py
./test/test_bash_rendering.py
./test/test_ansi_colors.py
./test/test_sidechain_agents.py
./test/test_output_explicit.py
./test/test_codex_task_results.py
./test/test_markdown_file_rendering.py
./test/test_markdown_helpers.py
./test/test_renderer_code.py
./test/test_template_rendering.py
./test/test_tui_expansion.py
./test/test_tui_surrogate.py
./test/README.md
./test/test_task_id_linking.py
./test/test_image_paste_ids.py
./test/test_workflow_rendering.py
./test/test_monitor_rendering.py
./test/test_cron_rendering.py
./test/test_cache_sqlite_integrity.py
./test/test_memory_rendering.py
./test/test_phase8_message_variants.py
./test/test_index_disambiguation.py
./test/test_image_export.py
./test/test_performance.py
./test/test_continuation_fork.py
./test/test_codex_docs_plugin.py
./test/test_session_export.py
./test/test_template_utils.py
./test/test_memory_browser.py
./test/test_snapshot_markdown.py
./test/test_html_regeneration.py
./test/test_plugin_system.py
./test/test_away_summary.py
./test/test_hook_summary.py
./test/test_user_view_toggle_browser.py
./test/test_skill_pairing.py
./test/test_workflow_sidechannel_user.py
./test/test_codex_quickjs.py
./test/test_codex_token_accounting.py
./test/test_tui_output_warn.py
./test/test_session_id_ordering.py
./test/test_codex_walker.py

[project]
name = "claude-code-log"
version = "1.5.0"
description = "Convert Claude Code transcript JSONL files to HTML"
readme = "README.md"
requires-python = ">=3.10"
classifiers = [
    "Programming Language :: Python :: 3",
    "Operating System :: OS Independent",
]
license = "MIT"
license-files = ["LICEN[CS]E*"]
authors = [
    { name = "Daniel Demmel", email = "hello@danieldemmel.me" },
    { name = "Edward Z. Yang", email = "ezyang@mit.edu" },
]

dependencies = [
    "click>=8.3.0",
    "dateparser>=1.2.2",
    "pydantic>=2.12.0",
    "jinja2>=3.1.6",
    "mistune>=3.1.4",
    "toml>=0.10.2",
    "textual>=6.5.0",
    "packaging>=25.0",
    "gitpython>=3.1.52",
    "pygments>=2.19.2",
    "quickjs-ng>=0.15.1.1,<0.16",
]

[project.urls]
Homepage = "https://github.com/daaain/claude-code-log"
Issues = "https://github.com/daaain/claude-code-log/issues"

[project.scripts]
claude-code-log = "claude_code_log.cli:main"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.hatch.build]
exclude = ["/docs", "/test", "/scripts"]

[tool.pytest.ini_options]
testpaths = ["test"]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"
# Parallelise across all cores; worksteal rebalances heavyweight integration
# tests across workers (default `load` left workers idle while one slogged
# through the queue). Override with `-n0 --dist=no` for serial runs, or with
# `--dist=no --pdb` for debugging (worksteal distribution must be disabled).
addopts = "-n auto --dist=worksteal"
markers = [
    "tui: TUI tests using Textual framework (requires isolated event loop)",
    "browser: Browser integration tests using Playwright (requires Chromium)",
    "snapshot: Snapshot tests that must run serially (syrupy file ordering)",
    "integration: Integration tests with realistic JSONL data",
    "slow: Slower tests that measure performance (may take several seconds)",
    "benchmark: Performance benchmarks that output to GitHub Job Summary",
]

[tool.ty.environment]
# Use custom stubs for untyped libraries
extra-paths = ["stubs"]
# Check against all platforms (mirrors pyright's pythonPlatform = "All") rather
# than the host, so ty is deterministic regardless of who runs it. POSIX-only
# stdlib members used behind runtime guards (faulthandler.register,
# signal.SIGUSR1, os.mkfifo) then read as "possibly missing on win32" and carry
# a targeted `# ty: ignore[possibly-missing-attribute]` at each guarded site,
# instead of being hard `unresolved-attribute` errors on a Windows host (#276).
python-platform = "all"

[tool.ty.src]
# docs/gen_pages.py is a build-time mkdocs-gen-files script: it imports
# `mkdocs_gen_files` (a docs-only dependency) and the standalone helpers in
# scripts/ via sys.path manipulation, neither of which ty can resolve in the
# default environment. It is not part of the type-checked source (pyright only
# `include`s claude_code_log), so exclude it here to match that intent.
exclude = ["docs"]

[tool.pyright]
# Pyright configuration with strict settings
include = ["claude_code_log"]           # TODO: , "test"
exclude = ["**/__pycache__", "dist"]
stubPath = "stubs"
venvPath = "."
venv = ".venv"
reportMissingImports = true
reportMissingTypeStubs = true
pythonVersion = "3.10"
pythonPlatform = "All"
typeCheckingMode = "strict"
reportUnknownMemberType = true
reportUnknownParameterType = true
reportUnknownVariableType = true
reportUnknownArgumentType = true
reportPrivateImportUsage = true
reportUntypedFunctionDecorator = true
reportFunctionMemberAccess = true
reportIncompatibleMethodOverride = true

[tool.ruff]
target-version = "py310"

[tool.coverage.run]
source = ["claude_code_log"]
omit = ["*/tests/*", "*/test/*", "*/__pycache__/*", "*/venv/*", "*/.venv/*"]
relative_files = true
# sys.monitoring core (Py 3.12+): ~5x lower tracing overhead than the C
# tracer (unit-test step: +67% -> +14% wall time vs no coverage). On
# Py < 3.12 coverage warns "no-sysmon" once and falls back to the default
# core; data and reports are unaffected. Requires coverage >= 7.9 for the
# [run] core setting. COVERAGE_CORE env var still overrides (e.g.
# COVERAGE_CORE=ctrace to A/B time). NOTE: sysmon cannot measure branch
# coverage before Py 3.14 — if branch = true is ever enabled here, 3.12/
# 3.13 silently revert to the slow tracer.
core = "sysmon"

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "if self.debug:",
    "if settings.DEBUG",
    "raise AssertionError",
    "raise NotImplementedError",
    "if 0:",
    "if __name__ == .__main__.:",
    "class .*\\bProtocol\\):",
    "@(abc\\.)?abstractmethod",
]
show_missing = true
precision = 2

[tool.coverage.html]
directory = "htmlcov"

[dependency-groups]
dev = [
    "pytest>=8.3.5",
    "pytest-asyncio>=0.25.3",
    "pytest-cov>=5.0.0",
    "coverage[toml]>=7.9",  # [run] core setting (added in 7.9); older coverage warns 'unrecognized option' and silently falls back to the slow default core
    "ruff>=0.11.2",
    "pytest-xdist[psutil]>=3.6.1",
    "pyright>=1.1.408",
    "vulture>=2.14",
    "ty>=0.0.11",
    "pytest-playwright>=0.7.0",
    "syrupy>=5.0.0",
    # Reference test plugin for the plugin-system test suite. Doubles as
    # the canonical example for third-party plugin authors. See
    # test/_plugins/clmail/README.md.
    "claude-code-log-clmail-test",
]

docs = [
    "mkdocs>=1.6.1",
    "mkdocs-material>=9.5.0",
    "mkdocs-click>=0.8.1",
    "mkdocs-gen-files>=0.5.0",
]

[tool.uv.sources]
claude-code-log-clmail-test = { path = "test/_plugins/clmail", editable = true }

./.claude/skills/update-tools-coverage/check_codex_coverage.py
./.claude/skills/update-tools-coverage/check_coverage.py
./claude_code_log/__init__.py
./claude_code_log/builtin_plugins/__init__.py
./claude_code_log/builtin_plugins/codex_docs.py
./claude_code_log/cache.py
./claude_code_log/cli.py
./claude_code_log/converter.py
./claude_code_log/dag.py
./claude_code_log/discovery.py
./claude_code_log/factories/__init__.py
./claude_code_log/factories/agent_metadata_factory.py
./claude_code_log/factories/assistant_factory.py
./claude_code_log/factories/attachment_factory.py
./claude_code_log/factories/meta_factory.py
./claude_code_log/factories/priorities.py
./claude_code_log/factories/system_factory.py
./claude_code_log/factories/task_notification_factory.py
./claude_code_log/factories/teammate_factory.py
./claude_code_log/factories/tool_factory.py
./claude_code_log/factories/transcript_factory.py
./claude_code_log/factories/user_factory.py
./claude_code_log/git_remote.py
./claude_code_log/html/__init__.py
./claude_code_log/html/ansi_colors.py
./claude_code_log/html/assistant_formatters.py
./claude_code_log/html/async_formatter.py
./claude_code_log/html/renderer_code.py
./claude_code_log/html/renderer.py
./claude_code_log/html/system_formatters.py
./claude_code_log/html/teammate_formatter.py
./claude_code_log/html/tool_formatters.py
./claude_code_log/html/user_formatters.py
./claude_code_log/html/utils.py
./claude_code_log/image_export.py
./claude_code_log/json/__init__.py
./claude_code_log/json/renderer.py
./claude_code_log/markdown_plugins.py
./claude_code_log/markdown/__init__.py
./claude_code_log/markdown/renderer.py
./claude_code_log/migrations/__init__.py
./claude_code_log/migrations/runner.py
./claude_code_log/models.py
./claude_code_log/parser.py
./claude_code_log/plugins.py
./claude_code_log/providers/__init__.py
./claude_code_log/providers/agy.py
./claude_code_log/providers/base.py
./claude_code_log/providers/claude.py
./claude_code_log/providers/codex_messages.py
./claude_code_log/providers/codex_quickjs.py
./claude_code_log/providers/codex_tools.py
./claude_code_log/providers/codex_web.py
./claude_code_log/providers/codex.py
./claude_code_log/providers/registry.py
./claude_code_log/renderer_timings.py
./claude_code_log/renderer.py
./claude_code_log/tui.py
./claude_code_log/utils.py
./claude_code_log/workflow.py
./docs/gen_pages.py
./docs/hooks.py
./scripts/codex_snippet_coverage.py
./scripts/extract_message_samples.py
./scripts/gen_nested_agents_fixture.py
./scripts/gen_workflow_fixture.py
./scripts/gen_workflow_scriptpath_fixture.py
./scripts/generate_example_output.py
./scripts/generate_style_guide.py
./scripts/generate_tui_docs.py
./scripts/generate_tui_screenshots.py
=== TEMPLATES ===
./claude_code_log/html/templates/components/search_inline.html
./claude_code_log/html/templates/components/search.html
./claude_code_log/html/templates/components/session_nav.html
./claude_code_log/html/templates/components/timeline.html
./claude_code_log/html/templates/index.html
./claude_code_log/html/templates/transcript.html
./scripts/style_guide_output/index_style_guide.html
./scripts/style_guide_output/index.html
./scripts/style_guide_output/transcript_style_guide.html
=== DOCS/WORKFLOWS ===
./.github/workflows/ci.yml
./.github/workflows/docs.yml
./docs/gen_pages.py
./docs/hooks.py
./docs/index.md
./docs/reference/cli.md
./docs/restoring-archived-sessions.md

       1 claude_code_log/__init__.py
      29 claude_code_log/parser.py
      72 claude_code_log/discovery.py
      82 claude_code_log/image_export.py
     134 claude_code_log/renderer_timings.py
     343 claude_code_log/git_remote.py
     414 claude_code_log/plugins.py
     440 claude_code_log/markdown_plugins.py
     661 claude_code_log/workflow.py
     868 claude_code_log/utils.py
    1146 claude_code_log/dag.py
    1951 claude_code_log/cli.py
    1980 claude_code_log/cache.py
    2179 claude_code_log/tui.py
    2334 claude_code_log/models.py
    4328 claude_code_log/converter.py
    5706 claude_code_log/renderer.py
   22668 total

17:    convert_jsonl_to,
18:    convert_jsonl_to_html,
98:    output_format: str,
139:            output_format,
148:    extension = get_file_extension(output_format)
201:    output_format: str,
237:        _clear_provider_output(output_root, output_format)
247:        output_format=output_format,
286:def _clear_provider_output(output_root: Path, output_format: str) -> None:
292:    file_ext = get_file_extension(output_format)
295:        index_file = output_root / get_index_filename(output_format)
344:        d for d in projects_dir.iterdir() if d.is_dir() and list(d.glob("*.jsonl"))
380:        jsonl_files = list(project_path.glob("*.jsonl"))
381:        modified_files = cache_manager.get_modified_files(jsonl_files)
428:    # Convert the path to the expected format: replace slashes with hyphens
478:        d for d in projects_dir.iterdir() if d.is_dir() and list(d.glob("*.jsonl"))
545:                jsonl_files = list(project_dir.glob("*.jsonl"))
546:                if jsonl_files:
548:                        convert_jsonl_to_html(project_dir, silent=True)
624:                if d.is_dir() and list(d.glob("*.jsonl"))
666:    unrelated user `.json` files that must not be deleted.
668:    if file_ext == "json":
670:            *directory.glob("combined_transcripts*.json"),
671:            *directory.glob("session-*.json"),
677:    input_path: Path, all_projects: bool, output_format: str
680:    file_ext = get_file_extension(output_format)
689:                if d.is_dir() and list(d.glob("*.jsonl"))
712:            index_filename = get_index_filename(output_format)
762:       ``template.format()`` (which would raise ``KeyError`` at
768:    same parser Python uses for ``str.format`` decides what counts
800:@click.command()
801:@click.version_option(version=get_library_version(), prog_name="claude-code-log")
802:@click.argument("input_path", type=click.Path(path_type=Path), required=False)
803:@click.option(
810:        "With a recognised file suffix (.html/.md/.markdown/.json) treated "
817:@click.option(
829:@click.option(
843:@click.option(
848:@click.option(
853:@click.option(
858:@click.option(
863:@click.option(
871:@click.option(
887:@click.option(
892:@click.option(
897:@click.option(
902:    help="Clear generated output files (HTML or Markdown based on --format) and force regeneration",
904:@click.option(
909:@click.option(
915:@click.option(
917:    "--format",
918:    "output_format",
919:    type=click.Choice(["html", "md", "markdown", "json"]),
921:    help="Output format. Supports html, md/markdown, or json. When omitted, "
922:    "inferred from the --output file suffix (.md/.markdown/.html/.json); "
925:@click.option(
931:@click.option(
937:@click.option(
948:@click.option(
954:@click.option(
959:@click.option(
979:@click.option(
994:@click.option(
1002:@click.option(
1016:@click.option(
1022:        "error) if combined with --format html / --format json."
1025:@click.option(
1036:@click.option(
1042:@click.pass_context
1043:def main(
1060:    output_format: str,
1092:    logging.basicConfig(level=logging.WARNING, format="%(levelname)s: %(message)s")
1267:    # `--output` / `--format` are no-ops under --tui: the TUI's export
1273:        or ctx.get_parameter_source("output_format")
1277:            "Warning: --output / --format are ignored in --tui mode; "
1282:    # Infer --format from an explicit --output file suffix when -f was not
1284:    # than writing mismatched content (issue #222). `.md`/`.markdown` both
1285:    # imply the canonical `markdown` format. Skipped under --tui: both flags
1289:        from .utils import format_from_output_suffix
1291:        suffix_format = format_from_output_suffix(output)

#!/usr/bin/env python3
"""Render Claude transcript data to HTML format."""

from __future__ import annotations

import logging
import re
import time
from dataclasses import dataclass, field, replace
from pathlib import Path
from collections.abc import Iterable, Iterator
from typing import TYPE_CHECKING, Any, Optional, Tuple, cast
from datetime import datetime

if TYPE_CHECKING:
    from .cache import CacheManager
    from .dag import SessionTree
    from .workflow import WorkflowRun

from .models import (
    RenderingDepth,
    MessageContent,
    MessageMeta,
    MessageType,
    TranscriptEntry,
    AiTitleTranscriptEntry,
    AssistantTranscriptEntry,
    AttachmentTranscriptEntry,
    PassthroughTranscriptEntry,
    SystemTranscriptEntry,
    SummaryTranscriptEntry,
    QueueOperationTranscriptEntry,
    UserTranscriptEntry,
    ContentItem,
    TextContent,
    ToolResultContent,
    ToolUseContent,
    ThinkingContent,
    UsageInfo,
    # Structured content types
    AssistantTextMessage,
    AwaySummaryMessage,
    BashInputMessage,
    BashOutputMessage,
    CommandOutputMessage,
    CompactedSummaryMessage,
    HookAttachmentMessage,
    HookSummaryMessage,
    SessionHeaderMessage,
    SlashCommandMessage,
    SystemMessage,
    TaskNotificationMessage,
    TaskOutput,
    ThinkingMessage,
    ToolResultMessage,
    ToolUseMessage,
    WorkflowAgentMessage,
    WorkflowPhaseMessage,
    WorkflowToolInput,
    UnknownMessage,
=== CONVERTER HEAD ===
#!/usr/bin/env python3
"""Convert Claude transcript JSONL files to HTML."""

import bisect
import contextlib
import itertools
import json
import logging
import multiprocessing
import os
import re
import time
from collections import defaultdict
from collections.abc import Iterator
from concurrent.futures import ProcessPoolExecutor, as_completed
from dataclasses import dataclass, field
from datetime import datetime
from pathlib import Path
import traceback
from typing import Any, Dict, List, Optional, TYPE_CHECKING, cast

import dateparser

if TYPE_CHECKING:
    from collections.abc import Iterable

    from .cache import CacheManager
    from .providers.base import ProviderTokenTotals

from .utils import (
    coalesce_trunk_session_id,
    collect_trunk_session_ids,
    format_timestamp_range,
    get_parent_session_id,
    get_project_display_name,
    is_agent_session,
    should_use_as_session_starter,
    create_session_preview,
    get_warmup_session_ids,
)
from .cache import (
    CacheManager,
    SessionCacheData,
    get_all_cached_projects,
    get_cache_db_path,
    get_library_version,
)
from .parser import parse_timestamp
from .factories import create_transcript_entry
from .factories.teammate_factory import find_team_lead_body
from .models import (
    AiTitleTranscriptEntry,
    AttachmentTranscriptEntry,
    BaseTranscriptEntry,
    DEFAULT_DEPTH,
    RenderingDepth,
    PassthroughTranscriptEntry,
    TranscriptEntry,
    AssistantTranscriptEntry,
    QueueOperationTranscriptEntry,

125:def get_file_extension(format: str) -> str:
147:def get_index_filename(format: str) -> str:
153:    ext = get_file_extension(format)
154:    return "all-projects-summary.json" if ext == "json" else f"index.{ext}"
1953:def convert_jsonl_to(
2019:    ext = get_file_extension(format)
2168:        format == "html"
2544:    ext = get_file_extension(format)
2692:def generate_single_session_file(
2804:    ext = get_file_extension(format)
2833:def render_normalized_session_file(
2996:def render_provider_wholesale(
3002:    output_format: str = "html",
3081:    ext = get_file_extension(output_format)
3082:    suffix = _variant_suffix(depth, compact, output_format, no_timestamps, no_recaps)
3257:                        output_format,
3312:                    output_format,
3366:    renderer = get_renderer(output_format, image_export_mode)
3372:    if output_format in ("md", "markdown", "html"):
3380:    index_path = output_root / get_index_filename(output_format)
3647:    output_format: str = "html",
3669:        output_format: Output format (html, md, markdown)
3744:    variant = _variant_suffix(depth, compact, output_format, no_timestamps, no_recaps)
3745:    combined_ext = get_file_extension(output_format)
3855:                output_format,
3900:                            "format": output_format,
4284:    index_path = index_root / get_index_filename(output_format)
4285:    renderer = get_renderer(output_format, image_export_mode)
4292:    if expand_paths and output_format in ("md", "markdown", "html"):

=== json/renderer.py head ===
"""JSON renderer implementation for Claude Code transcripts."""

from __future__ import annotations

import dataclasses
import json
from enum import Enum
from pathlib import Path
from typing import Any, Optional, TYPE_CHECKING, cast

from pydantic import BaseModel

from ..cache import get_library_version
from ..models import TranscriptEntry
from ..renderer import (
    Renderer,
    TemplateMessage,
    generate_template_messages,
)


def _json_default(obj: Any) -> Any:
    """Serialization fallback for types dataclasses.asdict doesn't unwrap.

    Tool inputs/outputs on MessageContent are Pydantic models embedded inside
    dataclasses, and dataclasses.asdict leaves them untouched. Without this
    hook, json.dumps(default=str) would stringify them via __repr__ and lose
    all structure.
    """
    if isinstance(obj, BaseModel):
        return obj.model_dump(mode="json")
    if isinstance(obj, Enum):
        return obj.value
    if isinstance(obj, Path):
        return str(obj)
    return str(obj)


if TYPE_CHECKING:
    from ..cache import CacheManager
    from ..dag import SessionTree


class JsonRenderer(Renderer):
    """JSON renderer - exports the processed transcript tree as structured JSON.

    Mirrors HtmlRenderer / MarkdownRenderer: runs transcripts through
    ``generate_template_messages`` so the output honours ``--detail`` filtering
    and exposes the same processed tree (pairing, children, session nav) that
    the other renderers consume.
=== markdown/renderer.py head ===
"""Markdown renderer implementation for Claude Code transcripts."""

from __future__ import annotations

import functools
import html as _html
import json
import re
from pathlib import Path
from typing import TYPE_CHECKING, Any, Optional

import mistune
from mistune.renderers.markdown import MarkdownRenderer as _MistuneMarkdownRenderer

from ..cache import get_library_version
from ..html.utils import (
    is_memory_path,
    is_well_formed_html,
    memory_short_path,
    render_user_markdown,
)
from ..utils import (
    ARTIFACT_FAVICON_TEXT_MAX,
    format_timestamp,
    generate_unified_diff,
    is_safe_web_url,
    split_websearch_queries,
    strip_error_tags,
)
from ..models import (
    AssistantTextMessage,
    AwaySummaryMessage,
    BashInputMessage,
    BashOutputMessage,
    CommandOutputMessage,
    CompactedSummaryMessage,
    RenderingDepth,
    HookAttachmentMessage,
    HookSummaryMessage,
    ImageContent,
    SessionHeaderMessage,
    SlashCommandMessage,
    SystemMessage,
    SystemReminderContent,
    TaskNotificationMessage,
    TeammateMessage,
    TextContent,
    ThinkingMessage,
    ToolResultMessage,
    ToolUseMessage,

210:    get_template_environment,
293:class HtmlRenderer(Renderer):
305:    _class_dispatch_format: str = "html"
1669:            env = get_template_environment()
1670:            template = env.get_template("transcript.html")
1772:        env = get_template_environment()
1773:        template = env.get_template("index.html")
1809:    """Generate HTML from transcript messages using Jinja2 templates.
1837:    """Generate HTML for a single session using Jinja2 templates."""
1846:    """Generate an index HTML page listing all projects using Jinja2 templates.

name: Docs

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

# Allow the deploy job to publish to GitHub Pages.
permissions:
  contents: read
  pages: write
  id-token: write

# Avoid overlapping deploys; let an in-progress run finish.
concurrency:
  group: pages
  cancel-in-progress: false

env:
  # Silence the Material-for-MkDocs vendor banner about a future MkDocs 2.0.
  DISABLE_MKDOCS_2_WARNING: "true"

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - name: Install uv
        uses: astral-sh/setup-uv@v8.2.0
        with:
          enable-cache: true

      - name: Set up Python
        run: uv python install 3.12

      - name: Install docs dependencies
        run: uv sync --group docs

      - name: Build site (strict)
        run: uv run mkdocs build --strict

      - name: Upload site as artifact (downloadable preview)
        uses: actions/upload-artifact@v7
        with:
          name: site-preview
          path: site
          retention-days: 14

      - name: Upload Pages artifact
        if: github.ref == 'refs/heads/main'
        uses: actions/upload-pages-artifact@v3
        with:
          path: site

  deploy:
    # Only publish from main; PRs just run the strict build above.
    if: github.ref == 'refs/heads/main'
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4
=== mkdocs.yml ===
site_name: Claude Code Log
site_description: Convert Claude Code transcript JSONL files to readable HTML and Markdown
site_url: https://daaain.github.io/claude-code-log/
repo_url: https://github.com/daaain/claude-code-log
repo_name: daaain/claude-code-log
edit_uri: edit/main/docs/

docs_dir: docs

theme:
  name: material
  icon:
    repo: fontawesome/brands/github
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.top
    - navigation.instant
    - navigation.tracking
    - content.code.copy
    - content.action.edit
    - search.suggest
    - search.highlight
    - toc.follow
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode

plugins:
  - search
  - gen-files:
      scripts:
        - docs/gen_pages.py

hooks:
  - docs/hooks.py

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets

1:# Claude Code Log
13:## Project Overview
27:## Quickstart
35:## Key Features
55:## What Problems Does This Solve?
69:## Usage
71:### Interactive TUI (Terminal User Interface)
76:# Launch TUI for all projects (default behavior)
79:# Launch TUI for specific project directory
82:# Launch TUI for specific Claude project
104:### Default Behavior (Process All Projects)
107:# Process all projects in ~/.claude/projects/ (default behavior)
110:# Explicitly process all projects
113:# Process all projects and open in browser
116:# Process all projects with date filtering
120:# Skip individual session files (only create combined transcripts)
131:### Single File or Directory Processing
134:# Single file
137:# Specific directory
140:# Custom output location
143:# Open in browser after conversion
146:# Filter by date range (supports natural language)
151:### Feeding Past Conversations to an LLM
156:# Session → compact Markdown for LLM review
159:# Whole project history
173:### Linking Commit SHAs
178:# Self-hosted GitLab
181:# Same thing via env var (useful for TUI / repeated invocations)
188:## Project Hierarchy Output
206:### Index Page Features
215:## Message Types Supported
226:## HTML Output Features
242:## Markdown Output Features
254:## Installation
277:## Contributing
281:## Community Extensions
292:## TODO

claude_code_log/html/utils.py:876:def get_template_environment() -> Environment:
---search utils---
claude_code_log/html/utils.py:24:from jinja2 import Environment, FileSystemLoader, select_autoescape
claude_code_log/html/utils.py:835:# -- Template Environment -----------------------------------------------------
claude_code_log/html/utils.py:876:def get_template_environment() -> Environment:
claude_code_log/html/utils.py:885:        Configured Jinja2 Environment (cached after first call)
claude_code_log/html/utils.py:888:    env = Environment(
claude_code_log/html/utils.py:889:        loader=FileSystemLoader(templates_dir),

claude_code_log/models.py:62:    suffix (see ``utils.variant_suffix``).
claude_code_log/models.py:670:# Structured content models for user message variants.
claude_code_log/models.py:1031:# Structured content models for assistant message variants.
claude_code_log/models.py:1557:    schema also requires ``favicon``, but it's defaulted so variant
claude_code_log/models.py:1579:    # has shipped variants over time; tolerate unknown fields rather than
claude_code_log/dag.py:528:    current tool_use entry, creating a false fork.  Two variants:
claude_code_log/dag.py:530:    Variant 1 — User child's subtree is structural (no conversation):
claude_code_log/dag.py:535:    Variant 2 — User child continues, Assistant subtree dead-ends:
claude_code_log/dag.py:555:    # Variant 1: user children carry only structural content (attachments,
claude_code_log/dag.py:569:    # Variant 2: assistant subtrees are dead ends,
claude_code_log/dag.py:626:    conversation the existing ``_stitch_tool_results`` variants bail (they each
claude_code_log/dag.py:664:            # earlier variants; be conservative and don't claim this shape.
claude_code_log/markdown_plugins.py:64:# Tight ``\`sha\``` shape for the codespan-wrapped variant. Single
claude_code_log/renderer.py:4053:      the indicator is elided (mirrors the population pass's invariant).
claude_code_log/renderer.py:4125:            # Load-bearing invariant: this no-dead-anchor guarantee depends on
claude_code_log/converter.py:1325:    combined_transcripts{suffix}_N.html. The `variant_suffix` encodes
claude_code_log/converter.py:1326:    ``--detail``/``--compact`` variants (see `utils.variant_suffix`)
claude_code_log/converter.py:1327:    so each variant owns its own page files and cache rows.
claude_code_log/converter.py:1329:    base = f"combined_transcripts{variant_suffix}"
claude_code_log/converter.py:1339:        # full (which is now the ``.hook`` variant).
claude_code_log/converter.py:1352:    """List variant entry files present in a project directory.
claude_code_log/converter.py:1355:    each variant), sorted so the default (tool, empty-suffix) variant
claude_code_log/converter.py:1360:    "suffix": variant-suffix-string}`` dicts the index template can
claude_code_log/converter.py:1365:    variants: List[Dict[str, str]] = []
claude_code_log/converter.py:1367:        return variants
claude_code_log/converter.py:1369:        m = VARIANT_ENTRY_RE.match(entry.name)
claude_code_log/converter.py:1373:        variants.append(
claude_code_log/converter.py:1376:                "label": _variant_label_from_suffix(suffix),
claude_code_log/converter.py:1381:    variants.sort(key=lambda v: (v["suffix"] != "", v["suffix"]))
claude_code_log/converter.py:1382:    return variants
=== justfile test targets ===
1:# Pytest verbosity: quiet for AI agents (AI_AGENT set), verbose for humans
2:pytest_verbosity := if env("AI_AGENT", "") != "" { "-q" } else { "-v" }
5:default:
11:# Run unit + integration tests (excludes TUI, browser, and benchmark)
13:# the pytest-playwright plugin — it imports playwright (~1s) per xdist worker on
15:test:
16:    uv run pytest -p no:playwright -m "not (tui or browser or benchmark)" {{ pytest_verbosity }}
18:# Run benchmark tests serially for stable measurements (outputs to GITHUB_STEP_SUMMARY in CI). DEBUG_TIMING enables coverage of renderer_timings.py
19:test-benchmark:
20:    CLAUDE_CODE_LOG_DEBUG_TIMING=1 uv run pytest -n0 -m benchmark {{ pytest_verbosity }}
22:# Update snapshot tests (runs serially for deterministic file ordering)
23:update-snapshot:
24:    uv run pytest -n0 -m snapshot --snapshot-update {{ pytest_verbosity }}
26:# Run TUI tests (requires isolated event loop)
27:test-tui:
28:    uv run pytest -m tui {{ pytest_verbosity }}
30:# Run browser tests (requires Chromium)
31:test-browser:
32:    uv run pytest -m browser {{ pytest_verbosity }}
34:# Run integration tests with realistic JSONL data
35:test-integration:
36:    uv run pytest -m integration {{ pytest_verbosity }}
38:# Run all tests in sequence (separated to avoid event loop conflicts)
39:test-all:
42:    echo "🧪 Running all tests in sequence..."
43:    echo "📦 Running unit tests..."
44:    uv run pytest -p no:playwright -m "not (tui or browser or integration or benchmark)" {{ pytest_verbosity }}
45:    echo "🖥️  Running TUI tests..."
46:    uv run pytest -m tui {{ pytest_verbosity }}
47:    echo "🌐 Running browser tests..."
48:    uv run pytest -m browser {{ pytest_verbosity }}
49:    echo "🔄 Running integration tests..."
50:    uv run pytest -m integration {{ pytest_verbosity }}
51:    echo "📊 Running benchmark tests..."
52:    CLAUDE_CODE_LOG_DEBUG_TIMING=1 uv run pytest -n0 -m benchmark {{ pytest_verbosity }}
53:    echo "✅ All tests completed!"
55:# Run tests with coverage (all categories)
56:test-cov:
59:    echo "📊 Running all tests with coverage..."
60:    echo "📦 Running unit tests with coverage..."

# Claude Code Log Testing & Style Guide

This directory contains comprehensive testing infrastructure and visual documentation for the Claude Code Log template system.

## Test Data (`test_data/`)

Representative JSONL files covering all message types and edge cases:

**Note**: After the module split, import paths have changed:

- `from claude_code_log.parser import load_transcript, extract_text_content`
- `from claude_code_log.html.renderer import generate_html, format_timestamp`
- `from claude_code_log.converter import convert_jsonl_to_html`

### `representative_messages.jsonl`

A comprehensive conversation demonstrating:

- User and assistant messages
- Tool use and tool results (success cases)
- Markdown formatting and code blocks
- Summary messages
- Multiple message interactions

### `edge_cases.jsonl`

Edge cases and special scenarios:

- Complex markdown formatting
- Very long text content
- Tool errors and error handling
- System command messages
- Command output parsing
- Special characters and Unicode
- HTML escaping scenarios

### `session_b.jsonl`

Additional session for testing multi-session handling:

- Different source file content
- Session divider behavior
- Cross-session message ordering

### `real_projects/` (Integration Test Data)

Real-world JSONL data from open-source Claude Code projects, used for integration testing:

| Project | Size | Files | Purpose |
|---------|------|-------|---------|
| `-Users-dain-workspace-JSSoundRecorder` | ~528KB | 11 | Small project, quick tests |
| `-Users-dain-workspace-coderabbit-review-helper` | ~6.5MB | 40 | Empty file edge cases (9 empty files) |
| `-Users-dain-workspace-danieldemmel-me-next` | ~1.7MB | 11 | Multi-cwd sessions, path conversion |
| `-Users-dain-workspace-claude-code-log-sample` | ~9MB | 23 | Curated sample with size variety |

These files test:

- **Multi-project hierarchy processing** with `--projects-dir`
- **Cache operations** with realistic data volumes
- **Edge cases**: Empty files, naming ambiguity, path conversion

13:factory builds its candidate ``MessageContent``, then the loader walks
27:from importlib.metadata import EntryPoint, entry_points
50:from .models import MessageContent, MessageMeta
61:    """A plugin contribution that rewrites a parsed ``MessageContent``.
65:    ``MessageContent`` (typically a plugin-defined subclass of one of
78:    applies_to: ClassVar[tuple[type[MessageContent], ...]]
82:        content: MessageContent,
84:    ) -> Optional[MessageContent]: ...
94:    # Returning a wholly unrelated MessageContent subclass (e.g. a
98:    # narrows to ``UserMessageContent``). A v2 enhancement may add a
118:    - ``applies_to``: non-empty tuple of MessageContent subclasses
158:        if not isinstance(t, type) or not issubclass(t, MessageContent):
160:                "plugin %r: applies_to entry %s is not a MessageContent subclass",
214:    seen: dict[tuple[int, tuple[type[MessageContent], ...]], MessageTransformer] = {}
250:    for ep in entry_points(group=ENTRY_POINT_GROUP):
270:    candidate: MessageContent,
272:) -> MessageContent:
286:       ``MessageContent`` instance AND match the transformer's
288:       declared types). A wholly-unrelated MessageContent — e.g. a
309:        # Static type-checkers see the Protocol's Optional[MessageContent]
314:        if not isinstance(replacement, MessageContent):  # pyright: ignore[reportUnnecessaryIsInstance]
316:                "plugin %r: transform() returned non-MessageContent %r; skipping",
=== README Community Extensions ===
## 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
- integrate `claude-trace` request logs if present?
- convert images to WebP as screenshots are often huge PNGs – this might be time consuming to keep redoing (so would also need some caching) and need heavy dependencies with compilation (unless there are fast pure Python conversation libraries? Or WASM?)
- add special formatting for built-in tools: Glob, Grep, LS, MultiEdit, NotebookRead, NotebookEdit, WebFetch, TodoRead, WebSearch
- add `ccusage` like daily summary and maybe some textual summary too based on Claude generate session summaries?
– import logs from @claude Github Actions
- stream logs from @claude Github Actions, see [octotail](https://github.com/getbettr/octotail)
- wrap up CLI as Github Action to run after Cladue Github Action and process [output](https://github.com/anthropics/claude-code-base-action?tab=readme-ov-file#outputs)
- feed the filtered user messages to headless claude CLI to distill the user intent from the session
- filter message type on Python (CLI) side too, not just UI
- add minimalist theme and make it light + dark; animate gradient background in fancy theme
- do we need special handling for hooks?
- make processing parallel, currently we only use 1 CPU (core) and it's slow
- merge git worktree directories

3:Generate a visual style guide showing all message types and rendering styles.
6:different types of Claude transcript messages are rendered, serving both as a
22:from claude_code_log.html.renderer import generate_projects_index_html
23:from claude_code_log.markdown.renderer import MarkdownRenderer
26:def create_style_guide_data():
235:                        "text": '⚙️ **System Command Example**\n\n<command-name>style-guide-test</command-name><command-args>--format json --output /tmp/test.json</command-args><command-message>Testing system command rendering in style guide</command-message><command-contents>{"text": "This is the command content with JSON data:\\n{\\n  \\"name\\": \\"Style Guide Test\\",\\n  \\"version\\": \\"1.0.0\\",\\n  \\"description\\": \\"Demonstrates command content formatting\\"\\n}"}</command-contents>',
256:                        "text": "📤 **Command Output Example**\n\n<local-command-stdout>Style Guide Test Results:\n✓ Message rendering: PASSED\n✓ Markdown processing: PASSED\n✓ Tool use formatting: PASSED\n✓ Error handling: PASSED\n✓ System commands: PASSED\n✓ Unicode support: PASSED\n\nTotal tests: 6\nPassed: 6\nFailed: 0\n\nTimestamp: 2025-06-14T10:02:10Z\nStatus: ALL_TESTS_PASSED\n\nStyle guide generation completed successfully! 🎉</local-command-stdout>",
302:                        "text": '🌍 **Special Characters & Unicode Example**\n\nThe transcript viewer supports full Unicode:\n\n**Accented characters:** café, naïve, résumé, piñata\n**Non-Latin scripts:** 中文, العربية, русский, ελληνικά, हिन्दी\n**Mathematical symbols:** ∑∆√π∞≈≠±×÷\n**Currency symbols:** $¢£€¥₹₿\n**Arrows and symbols:** →←↑↓⇒⇐↔️⚡⭐\n**Emojis:** 🎉🚀🎯🔥💡🌟⚙️📝🎨🎭\n\n**Code with special chars:**\n```python\n# Unicode in code comments: π ≈ 3.14159\ndef calculate_π():\n    return 22 / 7  # Approximation of π\n    \n# String with Unicode\ngreeting = "Hello, 世界! 🌍"\nprint(f"Mathematical: √16 = {16**0.5}")\n```\n\nAll characters should render correctly without breaking the layout!',
319:            "summary": "📋 **Summary Example** - This style guide demonstrated all major message types: user messages, assistant responses, tool usage (both successful and error cases), system commands, command outputs, long text handling, special character support, and this summary. The transcript viewer properly renders markdown, handles tool interactions, manages text wrapping, and supports full Unicode character sets. All visual elements maintain consistent styling and readability.",
325:def create_index_style_guide_data():
326:    """Create sample project data for index template testing."""
647:def generate_style_guide():
661:    style_guide_data = create_style_guide_data()
680:            jsonl_file, output_dir / "transcript_style_guide.html"
688:            output_dir / "transcript_style_guide.md",
694:    index_data = create_index_style_guide_data()
700:    index_html_file = output_dir / "index_style_guide.html"
705:    md_renderer = MarkdownRenderer()
706:    index_md_content = md_renderer.generate_projects_index(
709:    index_md_file = output_dir / "index_style_guide.md"
792:        <strong>About this style guide:</strong> This collection demonstrates how different types of Claude transcript messages are rendered in the HTML viewer. It serves as both visual documentation and a testing reference for developers working on the transcript rendering system.
799:                Comprehensive demonstration of all message types including user messages, assistant responses, tool usage, system commands, errors, and special formatting. Shows markdown rendering, code highlighting, tool interactions, and Unicode support.
801:            <a href="transcript_style_guide.html" class="guide-link">View Transcript Guide</a>
807:                Shows how the project index page renders with multiple projects, summary statistics, and various project naming conventions. Demonstrates the dashboard view that users see when browsing multiple transcript collections.
809:            <a href="index_style_guide.html" class="guide-link">View Index Guide</a>

7809726 chore(dashboard): 啟動訊息去掉 0.0.0.0 註記(下一行本有安全警示)
ca0038c chore(dashboard): 啟動訊息帶 http:// 完整 URL(終端可點直開 browser)
13a6ff0 feat(VIZ): 時間帶點擊=跳到該時刻(ledger 捲動+右側出 content)
a56d336 feat(VIZ): trajectory.html — 抄 DeepSeek harness Trajectory 排版的自足單檔軌跡視圖
aef943a docs(research): DeepSeek Trajectory / claude-code-log / ARCP 可視化三方比較
3205c2d chore(release): v0.2.0 — version bump + CHANGELOG 定版
79f4973 docs(operator): log 地圖(六類 log 路徑/看法/回收)+ 長駐維護 checklist
4a9f5d1 feat(FR-43): systemd 化 — poller -m 0 常駐(deploy/systemd 範本+operator §1.5)
9c44aee docs(srs): requirement 完成度覆核 — FR-45 補實測轉 ✅ + 六處校正
fe1f1ce feat(rerun): 「資訊更新後同票重跑」use case — 乾淨重跑指令(含 ABORTED 復活)
3873d29 feat(rawcli): agent.command 執行檔覆寫 + extra_args + model 未設不帶參數
f2f77c9 chore(release): v0.1.0 — CHANGELOG 定版
da36e4d fix(docs): mermaid 4 張時序圖 GitHub 渲染失敗——訊息文字含分號被當語句分隔
764b40f docs(release): 全文件審查修正 — CHANGELOG 補齊 08-10 後全部波次 + 9 處過時點
c70f6ff docs(release): sequence charts 全場景 + Config 參數參考 + 三層測試撰寫指南
bad5c0b Revert "feat(B 案): agent+browser skill 驗收 web — 內網無 Claude in Chrome 的替代"
b329e14 feat(B 案): agent+browser skill 驗收 web — 內網無 Claude in Chrome 的替代
5eb243a feat(稽核曝光): 一次性連結清單+表單唯讀頁 顯示提交時間/email/IP
fb5595c fix(HIL): T10 hold 全鏈打通(8/8)+ T13 auto_close 收官(4/4)— 第 6 個 bug
6c1999f feat(HIL 驗收): it_kp2 T10-T14 全路徑真環境測項 + 修掉 5 個產品 bug
d4cfcf3 docs(srs): 系統需求書 — 含 L0-L4 定位、場景、User Story+驗收、agent 艦隊
56ec79b feat(R 波): 研究建議落地 — headless 排程/背景/stall/漏入 五道防線
0cddb87 docs(map): HANDOFF/BACKLOG 記 P/Q 波完成
acf3348 test(KP2): T9 P/Q 真票驗收——插值+存證+結案回寫 9/9(KP2-21)
896634f feat(P/Q): TICKET.md 變數插值 + 過程存證 + 結案回寫(設計討論 8 分支定案)
2e97bb1 docs: interactive→headless 遷移指南 + 研究報告補 codex/隔離實驗(4-6)
27f5118 docs(research): headless CLI × 排程/subagent 風險研究(三實驗實證)
001cad5 docs(HIL/TICKET.md): 八份文件補「等人全狀況」與「任務簡報資訊流」——按讀者分層
035ada2 feat(E1/E2): 真環境驗證補完 — codex 對照數據點 + crash→resume 硬證據
28166ca docs: L2→L3 兩張手繪風 16:9 資訊圖卡(背景/Why/What/Key + How 全細節)
00eef21 docs(handoff): 主題 L/e2e_commands/KP2 現況同步
71e2b1a feat(C6): A/B 對照(手選版)— Dashboard 勾 profile 比 C3 全指標
896a148 feat(C3): KPI 框架 — First-pass close 雙報 + 效率 + 制衡 + coverage
8c38640 feat(it_kp2): T7 同票換手 / T8 跨票換手+評分必填負向 — 真跑 12/12
0b701aa feat(審批表單化): 起點審批改一次性表單 — 提交即放行,人不再編 description
fded1db fix(e2e_commands 結案): 三個真 bug — jql 舊 label / flaky 設計 / F1 閘門雙重計數
18de44a feat(CQ 去重): CRID 兩層去重 — harness 必擋 + REST 預濾(時窗補齊)
ee0825f feat(隔離+T6): 整測/正式整組隔離(--config/--runtime)+ 審批門放行全程
bd1abad fix(mention): Cloud ADF @mention 用 mention node 而非死文字(browser 實測抓到)
31c3f3c feat(M3+KP2): 安全掃描端到端實測 — skill-scanner 接上 + sort_findings + T5
ea3c61a fix(KP2): reload 對無 source 的 mock disp 容錯(test_hotreload)
f70f6cf feat(KP2-C): 實測首輪全過 — 中繼修復 + T2 選票強化 + browser E2E 記錄
d75c499 feat(KP2-B): integration/E2E 測試資產 + 實測首輪抓到的兩個 bug 修復
afa988f feat(KP2-A): KP2 整測資產 — 寫作/C review profiles+skills+routes+agent-job
19575bf feat(N): Jira 狀態同步 + config 切 KP2(模擬內網 workflow 整合)
df54393 feat(M3): TICKET.md 安全掃描(skill-scanner 靜態)+ HIL 安全審表單
99f1a17 feat(M2): TICKET.md 移除留言段 + abort_reason 泛化(中止理由統一)
a62976a feat(M1): config 腳本統一規範 — select.script 也必放 config/scripts/ subfolder
657026c feat(L6-L7): email→識別碼解析查序 + user_dir 快取 + DC 設計/首驗文件
105948c feat(L5): DC wiki/純文字格式 — comment/description/交付物雙格式

BACKLOG.md
CHANGELOG.md
tests/test_trajectory_html.py
docs/research/2026-08-trajectory-viz-comparison.md
docs/research/2026-08-jira-agent-harness-design-v5.md
docs/research/README.md
src/arcp/trajectory_html.py
src/arcp/transcript.py
src/arcp/rawcli/agent.py

./tests/test_trajectory_html.py
./src/arcp/trajectory_html.py
./docs/research/2026-08-trajectory-viz-comparison.md
./src/arcp/__pycache__/trajectory_html.cpython-312.pyc
./runtime-test/tickets/kp2-auto__KP2-37__10080/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-41__10084/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-31__10074/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-36__10079/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-29__10072/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-16__10053/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-25__10068/transcript/trajectory.html
./runtime-test/tickets/kp2-creview__KP2-17__10054/transcript/trajectory.html
./runtime-test/tickets/kp2-auto__KP2-32__10075/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-27__10070/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-38__10081/transcript/trajectory.html
./runtime-test/tickets/kp2-auto__KP2-30__10073/transcript/trajectory.html
./runtime-test/tickets/kp2-auto__KP2-26__10069/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-21__10064/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-24__10067/transcript/trajectory.html
./runtime-test/tickets/kp2-auto__KP2-35__10078/transcript/trajectory.html
./runtime-test/tickets/kp2-browser__KP2-42__10085/transcript/trajectory.html
./runtime-test/tickets/kp2-creview__KP2-16__10053/transcript/trajectory.html
./runtime-test/tickets/kp2-auto__KP2-39__10082/transcript/trajectory.html
./runtime-test/tickets/approval-demo__KP2-19__10062/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-33__10076/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-40__10083/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-22__10065/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-34__10077/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-20__10063/transcript/trajectory.html
./runtime-test/tickets/kp2-lowbud__KP2-23__10066/transcript/trajectory.html
./runtime-test/tickets/kp2-writer__KP2-28__10071/transcript/trajectory.html

src/arcp/transcript.py:155:    # VIZ(2026-08-15):同場產 trajectory.html(抄 DeepSeek Trajectory 排版;
src/arcp/transcript.py:156:    # 從 attempts/a*.events.jsonl 渲染,與 cclog 的 final.html 並存)。best-effort。
src/arcp/transcript.py:158:        from .trajectory_html import render_trajectory
src/arcp/transcript.py:161:        tj = render_trajectory(
src/arcp/transcript.py:163:            os.path.join(out_dir, "trajectory.html"),
src/arcp/transcript.py:168:        log.warning("trajectory.html 產生失敗(%s):%s", session_id, e)
src/arcp/rawcli/agent.py:23:def _msg_event(text: str, source: str, category: str = "text") -> dict:
src/arcp/rawcli/agent.py:25:    kind/source/llm_message.content)。category(VIZ 2026-08-15):
src/arcp/rawcli/agent.py:26:    text|tool|tool_result|thinking|user——trajectory.html 泳道分類用;
src/arcp/rawcli/agent.py:33:        "category": category if source == "agent" else "user",
src/arcp/rawcli/agent.py:273:    def _emit(self, on_event, text: str, category: str = "text") -> None:
src/arcp/rawcli/agent.py:277:        on_event(_msg_event(text, "agent", category))
src/arcp/rawcli/agent.py:295:                               category="tool")
src/arcp/rawcli/agent.py:298:                               category="thinking")
src/arcp/rawcli/agent.py:307:                               category="tool_result")
src/arcp/rawcli/agent.py:327:                           category="tool")

{"kind": "MessageEvent", "id": "63871bff-2355-4dc7-96e0-715523c346e7", "timestamp": "2026-08-13T18:36:19.692349", "source": "user", "parent_id": null, "llm_message": {"role": "user", "content": [{"type": "text", "text": "請先閱讀工作目錄裡的 TICKET.md,完成其中「描述」段落交付的任務。完成後回覆一行 TASK_DONE。"}]}}
{"kind": "MessageEvent", "id": "e99f49b5-bfa5-47b2-b13b-d224d6393a81", "timestamp": "2026-08-13T18:36:23.739980", "source": "agent", "parent_id": null, "llm_message": {"role": "assistant", "content": [{"type": "text", "text": "💭 根據 CLAUDE.md 的指示，我需要:\n1. 先讀 TICKET.md 了解任務\n2. 執行工作\n3. 完成後回覆 TASK_DONE\n\n讓我先讀 TICKET.md。"}]}}
{"kind": "MessageEvent", "id": "0cba7804-46cc-4b82-afa9-ecfe0b331861", "timestamp": "2026-08-13T18:36:24.603721", "source": "agent", "parent_id": null, "llm_message": {"role": "assistant", "content": [{"type": "text", "text": "🔧 Read /Users/swchen.tw/git/agents-control-platform/runtime-test/tickets/kp2-writer__KP"}]}}
---LS attempts---
attempts
transcript
ws
---find events---
runtime-test/tickets/kp2-writer__KP2-41__10084/attempts/a1.events.jsonl

===
13a6ff02e52ca39a8e68e57b73f20d8be84875ed
Shaowei Chen Sat Aug 15 20:46:57 2026 +0800
feat(VIZ): 時間帶點擊=跳到該時刻(ledger 捲動+右側出 content)

使用者回饋:無選取時單點 Overview——點中色塊=選該事件、點空白=跳到
該時刻最近的事件(select=光暈+ledger 捲動高亮+details 全文)。

實作三修:
- pointer capture 下 click target 恆為 track(span onclick 從未生效)
  → 改座標命中測試 hitSpan(x, laneY)
- 滑鼠微動 1px 就把 range 設成微區間、pointerup 清除分支吃掉點擊
  → 拖選過閾值(0.5%)才成立;清除判斷改「按下前已有選取」(hadRange)
- 空白點擊 → jumpTo(最近事件,含跨泳道)

KP2-41 真頁 browser 驗過(點 user 色塊→row8 hold 指示高亮+右側全文)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MbHSnHfJBNowQ5JCahGqVx

===
a56d336e5de0048e89c401ba7268a5777e88e912
Shaowei Chen Sat Aug 15 20:26:03 2026 +0800
feat(VIZ): trajectory.html — 抄 DeepSeek harness Trajectory 排版的自足單檔軌跡視圖

研究 ~/git/deepseek-harness ui-trajectory 後定案 B 案:不動 zero-diff 的
cclog vendor,自寫產生器與 final.html 並存。

- src/arcp/trajectory_html.py:attempts/a*.events.jsonl → 三件套自足單檔
  (頂部 3 語意泳道 Overview / 中 ledger #·事件chip·內容 / 右側可拖寬
  details 含 Content/Timing 頁籤);純 vanilla js 零外部資源
- 抄齊八項:token 兩層配色(明暗 alias,角色色=品牌藍/紫/amber/red)、
  sequence|time 投影切換、wheel 錨點縮放(exp 0.0015)+右鍵平移/清除、
  拖選區間→ledger 聯動+區間外 100vw shadow 打暗、opacity 聚焦(未選 0.2/
  搜尋不中 0.14)、hover 光暈+500ms tooltip、turn(attempt)邊界線、
  末事件最小寬不捏造時長
- rawcli 蒸餾事件加 category 欄(text/tool/tool_result/thinking/user;
  舊檔 emoji 前綴 fallback)——dashboard 對話視圖同一資料零改
- transcript.finalize 自動產出(best-effort);dashboard transcript 卡
  動態列檔=零改自動出現按鈕
- tests/test_trajectory_html.py 10/10;KP2-41 真資料 browser 驗證
  (三泳道/內容欄/details/sequence 投影全過);pyproject 對模板檔放寬 E501

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MbHSnHfJBNowQ5JCahGqVx

===
aef943abbd5694587d3f9a3600997518553effcf
Shaowei Chen Sat Aug 15 19:59:09 2026 +0800
docs(research): DeepSeek Trajectory / claude-code-log / ARCP 可視化三方比較

研究 ~/git/deepseek-harness 的 ui-trajectory(React 三件套:頂部 Overview
時間帶/中 ledger/右側可拖寬 details)與 vendored claude-code-log(對話
卡片流+15 組糖果色泳道),對照我們的 timeline:八項可學(TTFT/decoding
漸層分段、opacity 聚焦、sequence 等寬投影、3 條語意泳道、配色 token 化、
拖選聯動、details 頁籤化、hover/reduced-motion 紀律)+明確不搬清單
(React/虛擬滾動;保留跨票全域視角)。BACKLOG VIZ 條目記落地路線
(cclog zero-diff 不動,戰場=ticket 頁或自寫 trajectory.html 並存)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MbHSnHfJBNowQ5JCahGqVx

====STAT a56d336====
 BACKLOG.md                                         |   2 +-
 CHANGELOG.md                                       |   9 +-
 docs/research/2026-08-trajectory-viz-comparison.md |  11 +-
 pyproject.toml                                     |   2 +
 src/arcp/rawcli/agent.py                           |  23 +-
 src/arcp/trajectory_html.py                        | 366 +++++++++++++++++++++
 src/arcp/transcript.py                             |  14 +
 tests/test_trajectory_html.py                      |  85 +++++
 uv.lock                                            |   2 +-
 9 files changed, 502 insertions(+), 12 deletions(-)

/Users/swchen.tw/git/claude-code-log:
CHANGELOG.md
claude_code_log
CLAUDE.md
CONTRIBUTING.md
dev-docs
docs
justfile
LICENSE
mise.toml
mkdocs.yml
pyproject.toml
README.md
scripts
stubs
test
uv.lock
work

/Users/swchen.tw/git/claude-code-log-trajectory:

/Users/swchen.tw/git/claude-code-log/claude_code_log:
__init__.py
builtin_plugins
cache.py
cli.py
converter.py
dag.py
discovery.py
factories
git_remote.py
html
image_export.py
json
markdown
markdown_plugins.py
migrations
models.py
parser.py
plugins.py
providers
py.typed
renderer_timings.py
renderer.py
tui.py
utils.py
workflow.py
0a3327d Codex provider: decode each rollout once (token-totals seam + fork-prefix fan-out) (#302)

       1 /Users/swchen.tw/git/claude-code-log/claude_code_log/__init__.py
    1980 /Users/swchen.tw/git/claude-code-log/claude_code_log/cache.py
    1951 /Users/swchen.tw/git/claude-code-log/claude_code_log/cli.py
    4328 /Users/swchen.tw/git/claude-code-log/claude_code_log/converter.py
    1146 /Users/swchen.tw/git/claude-code-log/claude_code_log/dag.py
      72 /Users/swchen.tw/git/claude-code-log/claude_code_log/discovery.py
     343 /Users/swchen.tw/git/claude-code-log/claude_code_log/git_remote.py
      82 /Users/swchen.tw/git/claude-code-log/claude_code_log/image_export.py
     440 /Users/swchen.tw/git/claude-code-log/claude_code_log/markdown_plugins.py
    2334 /Users/swchen.tw/git/claude-code-log/claude_code_log/models.py
      29 /Users/swchen.tw/git/claude-code-log/claude_code_log/parser.py
     414 /Users/swchen.tw/git/claude-code-log/claude_code_log/plugins.py
     134 /Users/swchen.tw/git/claude-code-log/claude_code_log/renderer_timings.py
    5706 /Users/swchen.tw/git/claude-code-log/claude_code_log/renderer.py
    2179 /Users/swchen.tw/git/claude-code-log/claude_code_log/tui.py
     868 /Users/swchen.tw/git/claude-code-log/claude_code_log/utils.py
     661 /Users/swchen.tw/git/claude-code-log/claude_code_log/workflow.py
     176 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/__init__.py
     268 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/ansi_colors.py
     137 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/assistant_formatters.py
     175 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/async_formatter.py
     333 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/renderer_code.py
    1850 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/renderer.py
     302 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/system_formatters.py
     568 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/teammate_formatter.py
    1919 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/tool_formatters.py
     599 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/user_formatters.py
     896 /Users/swchen.tw/git/claude-code-log/claude_code_log/html/utils.py
     388 /Users/swchen.tw/git/agents-control-platform/src/arcp/trajectory_html.py
   30279 total

222:class TemplateMessage:
717:def generate_template_messages(
5266:class Renderer:
5288:    # standalone (it emits markdown anyway). See _dispatch_format docstring.
5289:    _class_dispatch_format: str = "markdown"
5291:    def _dispatch_format(self, obj: Any, message: TemplateMessage) -> str:
5302:           ``markdown`` or ``html`` per ``_class_dispatch_format``).
5307:        ``work/tool-renderer-plugins.md`` §``_dispatch_format``
5313:        method_attr = f"format_{self._class_dispatch_format}"
5330:        Same two-strategy resolution as :meth:`_dispatch_format`:
5357:        return self._dispatch_format(message.content, message)
5536:        return self._dispatch_format(content.input, message)
5542:        return self._dispatch_format(content.output, message)
5641:def get_renderer(

16:902:    help="Clear generated output files (HTML or Markdown based on --format) and force regeneration",
19:921:    help="Output format. Supports html, md/markdown, or json. When omitted, "
20:1022:        "error) if combined with --format html / --format json."
27:1285:    # imply the canonical `markdown` format. Skipped under --tui: both flags
34:1298:                "markdown" if output_format in ("md", "markdown") else output_format
40:1332:    if no_timestamps and output_format not in ("md", "markdown"):

130:    return "md" if format in ("md", "markdown") else format
144:    return format in ("html", "md", "markdown")
154:    return "all-projects-summary.json" if ext == "json" else f"index.{ext}"
1728:    suffix = _variant_suffix(depth, compact, "html", no_recaps=no_recaps)
1940:        "html",
1977:        format: Output format ("html", "md", or "markdown").
2168:        format == "html"
2837:    format: str = "html",
3002:    output_format: str = "html",
3372:    if output_format in ("md", "markdown", "html"):
3647:    output_format: str = "html",
4292:    if expand_paths and output_format in ("md", "markdown", "html"):

# so we notice new kinds worth supporting (see the else branch in
# load_transcript). `progress` is not here because it has uuid+sessionId
# and participates in the DAG as a PassthroughTranscriptEntry.
SILENT_SKIP_TYPES: frozenset[str] = frozenset(
    {
        "file-history-snapshot",  # Internal file backup metadata
        "last-prompt",  # Trailing marker written as the last line of a .jsonl
        # Session metadata snapshots (positional state, no uuid/timestamp).
        # Recorded whenever Claude Code writes a state checkpoint to the
        # transcript; see #94 for the wider "propagate this state to
        # surrounding messages" follow-up.
        "permission-mode",  # {permissionMode: 'acceptEdits'|...}
        "mode",  # {mode: 'normal'|...}
        "custom-title",  # {customTitle: <str>}
        "agent-name",  # {agentName: <str>}
        "agent-color",  # {agentColor: <str>}
        # Written alongside a successful Artifact publish (#257):
        # {path, frameUrl, timestamp} maps the source file to the deployed
        # claude.ai page. No uuid; fully redundant with the Artifact
        # tool_result (same path and URL), which is rendered.
        "frame-link",
    }
)


def get_file_extension(format: str) -> str:
    """Get the file extension for a format.

    Normalizes 'markdown' to 'md' for consistent file extensions.
    """
    return "md" if format in ("md", "markdown") else format


def _tracks_version_marker(format: str) -> bool:
    """Whether a format's freshness is tracked via the html_cache path.

    ``CacheManager.is_transcript_stale`` sniffs the shared
    ``<!-- Generated by claude-code-log v… -->`` comment (via
    ``is_html_outdated``) to decide whether an on-disk artifact is current.
    Only HTML and Markdown emit that marker; JSON carries its freshness in a
    top-level ``version`` field instead, checked by ``JsonRenderer.is_outdated``.
    Routing JSON through the marker sniff would report every file "outdated"
    and re-render it on every run — so JSON keeps the renderer-based fallback.
    """
    return format in ("html", "md", "markdown")


def get_index_filename(format: str) -> str:
    """Get the all-projects index filename for a format.

    JSON uses `all-projects-summary.json` so it doesn't collide with the
    per-project JSON exports; other formats use `index.{ext}`.
    """
    ext = get_file_extension(format)
    return "all-projects-summary.json" if ext == "json" else f"index.{ext}"


def _scan_sidechain_uuids(directory: Path) -> set[str]:
    """Collect UUIDs from sidechain/subagent files not loaded into the DAG.

    Some subagent files (e.g. aprompt_suggestion) are never referenced
    via agentId in the main session, so they aren't loaded by
    load_transcript(). Their UUIDs are needed to suppress false orphan
    warnings when main-chain entries reference sidechain parents.
    """
    uuids: set[str] = set()
    # ``*/subagents/*.jsonl`` covers ordinary sub-agent/teammate files;
    # ``*/subagents/workflows/*/*.jsonl`` covers dynamic-workflow side-channel
    # transcripts (issue #174) — their agent UUIDs are otherwise unseen and
    # would raise false orphan warnings. ``journal.jsonl`` has no ``uuid`` so
    # scanning it is harmless.
    workflow_files = directory.glob("*/subagents/workflows/*/*.jsonl")
    for f in itertools.chain(directory.glob("*/subagents/*.jsonl"), workflow_files):
        try:
            with open(f, "r", encoding="utf-8", errors="replace") as fh:
                for line in fh:
                    line = line.strip()
                    if not line:
                        continue
                    try:
                        raw = json.loads(line)
77:def _dag_warnings_suppressed(silent: bool) -> Iterator[None]:
125:def get_file_extension(format: str) -> str:
133:def _tracks_version_marker(format: str) -> bool:
147:def get_index_filename(format: str) -> str:
157:def _scan_sidechain_uuids(directory: Path) -> set[str]:
197:def filter_messages_by_date(
259:def load_transcript(
524:def _subagent_meta_map(
567:def _apply_subagent_meta_links(
628:def _link_subagents_by_prompt_hash(
691:def _collect_unresolved_task_results(
721:def _read_first_message_text(agent_file: Path) -> Optional[str]:
761:def _normalize_prompt(text: str) -> str:
766:def _integrate_agent_entries(messages: list[TranscriptEntry]) -> None:
852:def _splice_queue_ops_chronologically(
934:def load_directory_transcripts(
1027:def _is_empty_thinking(entry: TranscriptEntry) -> bool:
1041:def _resolve_survivor(uuid: str, remap: dict[str, str]) -> str:
1054:def deduplicate_messages(messages: list[TranscriptEntry]) -> list[TranscriptEntry]:
1201:def _merge_empty_thinking_runs(
1239:class GenerationStats:
1260:    def add_warning(self, msg: str) -> None:
1264:    def add_error(self, msg: str) -> None:
1268:    def summary(self, project_name: str) -> str:
1307:class RegenerationReport:
1321:def _get_page_html_path(page_number: int, variant_suffix: str = "") -> str:
1335:def _variant_label_from_suffix(suffix: str) -> str:
1349:def _enumerate_project_variants(
1392:def _enable_next_link_on_previous_page(
1423:    # Check if there's a last-page class to remove
1437:def _assign_sessions_to_pages(
1474:def compute_session_data(
1617:def compute_project_aggregates(messages: List[TranscriptEntry]) -> Dict[str, Any]:
1676:def _build_session_data_from_messages(
1693:def _generate_paginated_html(
1922:def convert_jsonl_to_html(
1953:def convert_jsonl_to(
2352:def ensure_fresh_cache(
2412:def _update_cache_with_session_data(
2442:def _collect_project_sessions(messages: list[TranscriptEntry]) -> list[dict[str, Any]]:
2496:def build_session_title(
2520:def _generate_individual_session_files(
2692:def generate_single_session_file(
2833:def render_normalized_session_file(
2878:def _provider_project_dirname(cwd: Optional[Path]) -> str:
2887:def _entry_timestamp_range(
2895:def _first_user_text(messages: List[TranscriptEntry]) -> Optional[str]:
2911:def _wholesale_should_render(
2937:def _sum_provider_token_totals(
2981:def _project_token_totals_from_messages(
2996:def render_provider_wholesale(
3392:def _get_cleanup_period_days() -> Optional[int]:
3414:def _print_archived_sessions_note(total_archived: int) -> None:
3436:class _ProjectPlan:
3456:def _plan_project(
3600:def _convert_project_worker(
3641:def process_projects_hierarchy(
3753:    def _rel_to_index(p: Path) -> str:
3811:    def _archived_suffix(plan: _ProjectPlan) -> str:
3814:    def _print_project_done(plan: _ProjectPlan, elapsed: float) -> None:
3826:    def _print_project_failed(plan: _ProjectPlan, error: str) -> None:
3849:    def _convert_plan_inline(plan: _ProjectPlan) -> None:

57:def split_websearch_queries(query: str) -> list[str]:
63:def variant_suffix(
116:def format_timestamp(timestamp_str: str | None) -> str:
130:def format_timestamp_range(first_timestamp: str, last_timestamp: str) -> str:
152:def _is_temp_path(path_str: str) -> bool:
162:def best_working_dir(
200:def get_project_display_name(
215:def path_looks_absolute(s: str) -> bool:
227:def _split_real_path_for_join(real_path_str: str) -> list[str]:
257:def project_dir_to_real_path(
340:def _peek_jsonl_for_cwd(jsonl_path: Path) -> Optional[str]:
385:def output_path_is_file(output: Path) -> bool:
396:def format_from_output_suffix(output: Path) -> Optional[str]:
406:def project_destination(
493:def should_skip_message(text_content: str) -> bool:
507:def should_use_as_session_starter(text_content: str) -> bool:
545:def create_session_preview(text_content: str) -> str:
593:def extract_text_content_length(content: list[ContentItem]) -> int:
606:def _compact_ide_tags_for_preview(text_content: str) -> str:
625:    def _extract_file_path(content: str) -> str | None:
706:def is_agent_session(session_id: str) -> bool:
715:def get_parent_session_id(session_id: str) -> str:
724:def get_warmup_session_ids(messages: list[TranscriptEntry]) -> set[str]:
759:def coalesce_trunk_session_id(
778:def collect_trunk_session_ids(
804:def is_safe_web_url(url: str) -> bool:
821:def strip_error_tags(text: str) -> str:
841:def generate_unified_diff(old_string: str, new_string: str) -> str: