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

claude_code_log-1.5.0/.devbox-foldyard/.gitignore

@@ -0,0 +1 @@
+*

claude_code_log-1.5.0/.github/workflows/ci.yml

@@ -0,0 +1,117 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: ["ubuntu-latest", "windows-latest"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        include:
+          - os: "ubuntu-latest"
+            python-version: "3.12"
+            is-primary: true
+
+    env:
+      # Collect coverage only on the primary job: it is the only one that
+      # uploads the reports and feeds the PR comment, while --cov costs
+      # ~65% extra pytest wall time (worst on Windows). Windows-only
+      # covered lines measured at 5 (diffing covered lines per file,
+      # Windows vs the primary artifact): the SIGUSR1 no-op return and the
+      # drive-letter branch of convert_project_path_to_claude_dir, both in
+      # cli.py. Those were never in the published report (non-primary
+      # coverage was computed and discarded), so this changes nothing.
+      COV: ${{ matrix.is-primary && '--cov=claude_code_log --cov-report=xml --cov-report=html --cov-report=term' || '' }}
+      COV_APPEND: ${{ matrix.is-primary && '--cov=claude_code_log --cov-append --cov-report=xml --cov-report=html --cov-report=term' || '' }}
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        # Full history so test/test_commit_linkifier.py's
+        # TestIntegrationLocalRepo can resolve SHAs older than the
+        # current tip (`git branch -r --contains` reads local refs
+        # only and needs the commits in the object DB).
+        fetch-depth: 0
+
+    - name: Move TEMP to the workspace disk (Windows)
+      # On windows runners TMP/TEMP default to the C: OS disk, whose
+      # throttled I/O dominates this tmp-heavy suite; RUNNER_TEMP lives on
+      # the same disk as the workspace (D:). Measured via A/B experiment
+      # (run 28715118956): this redirect alone took the unit selection from
+      # 555s mean to 150s — parity with ubuntu (~161s). Defender is NOT the
+      # culprit: real-time protection is already off on current images
+      # (exclusions/disable measured as no-ops), and a ReFS dev drive
+      # (~296s) was dominated by this redirect. Details: work/win-io.md
+      if: runner.os == 'Windows'
+      shell: pwsh
+      run: |
+        "TMP=$env:RUNNER_TEMP" >> $env:GITHUB_ENV
+        "TEMP=$env:RUNNER_TEMP" >> $env:GITHUB_ENV
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        enable-cache: true
+
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev && uv run playwright install chromium
+
+    - name: Run unit tests (coverage on primary only)
+      # -p no:playwright: unit tests don't use the browser fixtures; skipping the
+      # plugin avoids a ~1s playwright import per xdist worker, which Windows pays
+      # per spawned worker. See work/xdist-import-cost.md.
+      run: uv run pytest -p no:playwright -m "not (tui or browser or benchmark)" ${{ env.COV }}
+
+    - name: Run TUI tests (coverage append on primary only)
+      run: uv run pytest -m tui ${{ env.COV_APPEND }}
+
+    - name: Run browser tests (coverage append on primary only)
+      run: uv run pytest -m browser ${{ env.COV_APPEND }}
+
+    - name: Run benchmark tests with coverage append (primary only)
+      if: matrix.is-primary
+      env:
+        CLAUDE_CODE_LOG_DEBUG_TIMING: "1"
+      run: uv run pytest -m benchmark ${{ env.COV_APPEND }} -v
+
+    - name: Upload coverage HTML report as artifact
+      uses: actions/upload-artifact@v4
+      if: matrix.is-primary
+      with:
+        name: coverage-report-html
+        path: htmlcov/
+        retention-days: 30
+
+    - name: Upload coverage XML as artifact
+      uses: actions/upload-artifact@v4
+      if: matrix.is-primary
+      with:
+        name: coverage-report-xml
+        path: coverage.xml
+        retention-days: 30
+
+    - name: Coverage comment (PR only)
+      if: github.event_name == 'pull_request' && matrix.is-primary
+      uses: py-cov-action/python-coverage-comment-action@v3
+      with:
+        GITHUB_TOKEN: ${{ github.token }}
+        MINIMUM_GREEN: 75
+        MINIMUM_ORANGE: 60
+
+    - name: Run linting
+      run: uv run ruff check
+
+    - name: Run formatting check
+      run: uv run ruff format --check
+
+    - name: Run type checking
+      run: uv run pyright

claude_code_log-1.5.0/.github/workflows/docs.yml

@@ -0,0 +1,68 @@
+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

{claude_code_log-1.3.0 → claude_code_log-1.5.0}/.gitignore

@@ -147,6 +147,8 @@ venv.bak/
 
 # mkdocs documentation
 /site
+# Locally-generated TUI screenshots (regenerated at build time by gen-files)
+docs/assets/tui/
 
 # mypy
 .mypy_cache/
@@ -187,11 +189,10 @@ test/test_data/*.html
 .local.code-workspace
 local.ps1
 
-# Generated documentation examples (uploaded to GitHub releases instead)
-docs/claude-code-log-transcript.html
-docs/cache/
 
 # Integration test data - exclude generated cache/HTML, keep JSONL files
 test/test_data/real_projects/*/cache/
 test/test_data/real_projects/*/*.html
 test/test_data/real_projects/index.html
+# SQLite cache the CLI drops into a projects dir when run against test data
+claude-code-log-cache.db

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

@@ -6,6 +6,114 @@ 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.5.0] - 2026-07-09
+
+### Changed
+
+- **Filter <local-command-caveat>-wrapped caveat messages (Claude Code ≥ ~2.1) (#269)**
+- **Fix perpetual re-regeneration of projects with up-to-date caches (#268)**
+- **Fix ty possibly-missing-attribute warnings in tests (#267)**
+- **Speed up cache freshness checks on large archives (#266)**
+- **ci: move TMP/TEMP to the workspace disk on Windows runners**
+- **perf(cov): use sys.monitoring coverage core (COVERAGE_CORE=sysmon equivalent)**
+- **ci: collect coverage only on the primary matrix job**
+- **Improve Artifact tool look&feel: label-linked result, lean tool use (#262) (#263)**
+- **Remap dangling parent refs when dedup drops a distinct DAG node (#259) (#261)**
+- **Render the Artifact tool (deploy HTML/MD page → claude.ai URL) (#257) (#260)**
+- **Handle the full variety of Workflow invocation shapes (#174 follow-up) (#258)**
+- **Regenerate a --no-cache directory when a source .jsonl grows (#254) (#256)**
+- **Regenerate single-file output when its source grows; fix success-message accuracy (#221 follow-up) (#253)**
+- **Surface the model each agent ran on, once per agent context (#246) (#252)**
+- **feat: use nicer glyphs for fold/unfold controls (#247) (#255)**
+- **Escape raw HTML in assistant/tool content to fix XSS  (#245)**
+- **Warn that --output / --format are ignored under --tui (#220) (#241)**
+- **Speed up the SQLite metadata-cache build (connection reuse + synchronous=NORMAL) (#251)**
+- **Cut pytest-xdist per-worker import cost on Windows unit runs (#250)**
+- **Speed up integration-test fixtures on Windows (shrink copied transcripts; skip symlink tests when unavailable) (#249)**
+- **Stream output to stdout: support -o - / /dev/stdout (#223 part 2) (#239)**
+- **Keep fork points visible when their host message is detail-filtered (#233 follow-up) (#240)**
+- **Explicit --output: always regenerate, infer format from suffix, fix stdout hang (#221, #222, #223 part 1) (#237)**
+- **Connect fork-point and branch headers to their anchor message (#238)**
+- **Anchor fork points whose node is an unrendered system message (#236)**
+- **Render Read/Write of any Markdown file as Markdown, not Pygments (#232) (#234)**
+- **Generic tool results: render structured content items (#227) (#235)**
+- **Nested agent hierarchies: visual layer (#213, part 2 — WIP) (#219)**
+- **Render nested sub-agent hierarchies (#213) (#218)**
+- **Build(deps): bump pygments from 2.19.2 to 2.20.0 (#228)**
+- **Build(deps): bump requests from 2.32.5 to 2.33.0 (#229)**
+- **Build(deps-dev): bump pytest from 9.0.1 to 9.0.3 (#230)**
+- **Build(deps): bump idna from 3.11 to 3.15 (#231)**
+- **Side-channel prompt rendering + params-fold UX and accessibility (#174 follow-up) (#217)**
+- **Polish the workflow run tree + dev-docs sync (#174 follow-up) (#215)**
+- **Hybrid JSON/Markdown rendering for tool params tables (#216)**
+- **Linearize assistant-continuation tool-flow forks instead of branching (#214)**
+- **Enrich fork-point and branch nav labels with message summaries (#179 follow-up) (#212)**
+- **Render dynamic-workflow run tree on the nested DOM (#174 PR3) (#210)**
+- **Keep recaps visible at all detail levels; add --no-recaps (#179) (#209)**
+- **Dedupe "unrecognized message type" warnings per file (#211)**
+- **work/: delete the completed converter/renderer simplification plans (#208)**
+- **Flag auto-memory interactions: 🧠 titles + memory filter (#192) (#204)**
+- **Phase 3: single-axis collapse — delete pre-render _filter_by_detail (#206)**
+- **Render Workflow tool-input (JS) + async-result JSON bodies (#174 PR2) (#205)**
+- **Phase 2 of ghosting epic: detail-filter ghosts in place; drop _reindex_filtered_context (#194)**
+- **Parse dynamic-Workflow runs into WorkflowRun models (#174 PR1) (#203)**
+- **Bump mistune from 3.1.4 to 3.2.1 (#202)**
+- **Bump gitpython from 3.1.45 to 3.1.50 (#200)**
+- **Exclude docs/ from ty type-checking (#201)**
+- **Render message tree as nested DOM (PR0 for #174) (#191)**
+- **Bump urllib3 from 2.5.0 to 2.7.0 (#199)**
+- **Ghost-aware ctx.messages; skill-fold uses None slots (ghosting epic Phase 1) (#193)**
+- **Merge pull request #198 from daaain/fix-linux-release**
+
+
+## [1.4.0] - 2026-06-03
+
+### Changed
+
+- **Fix sed**
+- **Add MkDocs documentation site with live TUI reference (#197)**
+- **Relax Textual constraint from `==` to `>=` (#196)**
+- **Add `--version` flag to the CLI (#195)**
+- **Fix AskUserQuestion result rendering + highlight chosen options (#180) (#189)**
+- **Derive render_session_id from the SessionTree, not a loop variable (#190)**
+- **Fix collapsible body overlapping preceding content in tool cards (#153) (#187)**
+- **Extract compute_session_data + compute_project_aggregates (C9b) (#188)**
+- **Add C9a characterization tests for session-scan call sites (#186)**
+- **Route converter summary + ai-title extraction through shared helpers (#185)**
+- **status: Wave B fully merged; Wave C kickoff (C8/C9a/C9b stacked, C10 dropped, decisions locked)**
+- **Compute branch preview once from the DAG-line (#184)**
+- **status: #184 fully validated (CI 11/11, CodeRabbit clean) — ready to merge**
+- **docs: keep simplification status note self-contained to project scope**
+- **status: correct #184 state; move GitHub CI/CodeRabbit ops to github guideline**
+- **status: reverse-order stacked-PR lift recipe CONFIRMED on #184**
+- **Factor session-header construction out of _render_messages (#183)**
+- **status: #183/#184 rebased + CodeRabbit forced (#183 clean, #184 2 doc fixes); record @coderabbitai + reverse-order workarounds**
+- **Dedup requestId tokens in pagination cache-miss fallback (#182)**
+- **status: Wave B track complete — opp 7 PR #184 up, all monk-approved; add merge sequence**
+- **status: note stacked-PR CI/CodeRabbit defers to merge-time**
+- **status: opp 1 green (#182, awaiting merge); opp 6 #183 in review; opp 7 in progress**
+- **status: opp 1 -> PR #182 (in review); opp 6 in progress**
+- **Add live-status section to simplification plan**
+- **Add converter/renderer simplification plan**
+- **Move detail-visibility predicate onto MessageContent (#181)**
+- **Sync rendering-architecture.md §5 with the current pipeline (#178)**
+- **Extract inline junction-forward-link block into a named pass (#177)**
+- **Co-locate the away-summary detail rule on AwaySummaryMessage (#176)**
+- **Remove vestigial progress-chain parent repair (#175)**
+- **plugins: dev-docs gaps + public helper API + ToolResult example (Phase 2) (#173)**
+- **Implement unified plugin system from RFC #166 (#169)**
+- **Render Read tool results with pygments via structured payload (closes #170) (#172)**
+- **work/: triage against shipped main (#171)**
+- **Always regenerate projects index so variant-flag toggles refresh links (#168)**
+- **RFC: plugin system (unified message-transformer mechanism) (#166)**
+- **Per-message timestamps in Markdown output (#160) (#165)**
+- **Support non-GitHub forges via static map + `--git-link` fallback (#156) (#164)**
+- **Obsidian-friendly output: --output dir + --expand-paths + --filter-path (#151) (#155)**
+- **Linkify commit SHAs in rendered Markdown + HTML — closes #156 (#161)**
+- **CSS clean-ups (issue #153) (#163)**
+- **Cross-link TaskOutput / TaskUpdate headers back to their spawn (#154) (#158)**
+
+
 ## [1.3.0] - 2026-05-14
 
 ### Changed

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

@@ -107,9 +107,16 @@ with pointers to the deep-dive docs:
 - [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
+- [dev-docs/plugins.md](dev-docs/plugins.md) - Plugin system reference + author guide
 
 User-facing docs live in [docs/](docs/); plans and TODOs live in [work/](work/).
 
+A documentation site (MkDocs + Material) is published to GitHub Pages from
+`docs/` + `mkdocs.yml`. The CLI reference is rendered live from Click, and the
+TUI reference (keybindings + screenshots) is auto-generated at build time. See
+the "Documentation Site" section of @CONTRIBUTING.md. Preview with
+`just docs-serve`; strict build with `just docs-build`.
+
 ### Keeping dev-docs/ in sync
 
 `dev-docs/` is **as-built reference** — the code is the authoritative

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

@@ -206,6 +206,47 @@ 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.
 
+## Documentation Site
+
+The project publishes a documentation site to GitHub Pages, built with
+[MkDocs](https://www.mkdocs.org/) and the
+[Material](https://squidfunk.github.io/mkdocs-material/) theme. The site
+configuration is `mkdocs.yml`; pages live under `docs/`.
+
+```bash
+# Install docs dependencies
+uv sync --group docs
+
+# Live-reload preview at http://127.0.0.1:8000
+just docs-serve
+
+# Strict build (fails on broken links/nav — same as CI)
+just docs-build
+```
+
+Key points:
+
+- **CLI reference** (`docs/reference/cli.md`) is rendered live from the Click
+  command via the `mkdocs-click` plugin — no manual upkeep.
+- **TUI reference** (`reference/tui.md`) is generated at build time by
+  `docs/gen_pages.py` (a `mkdocs-gen-files` script): it introspects the Textual
+  `BINDINGS` for the keybindings tables (`scripts/generate_tui_docs.py`) and
+  captures SVG screenshots of the running TUI
+  (`scripts/generate_tui_screenshots.py`). Both scripts are runnable standalone.
+- **Example output** (`example.md` + `examples/transcript.html`) is rendered at
+  build time from a bundled sample project
+  (`scripts/generate_example_output.py`, also `just example`) — no private data
+  or release asset involved. Generation is fault-tolerant so a render hiccup
+  can't block the build.
+- **Development** section surfaces `dev-docs/` (symlinked as `docs/development`).
+  `CONTRIBUTING.md` and `CHANGELOG.md` are symlinked in as `docs/contributing.md`
+  and `docs/changelog.md`. A build hook (`docs/hooks.py`) rewrites links to repo
+  source files (e.g. `../claude_code_log/cli.py`) into GitHub URLs so the strict
+  build stays green.
+- Deployment is automated by `.github/workflows/docs.yml`: PRs run a strict
+  build; pushes to `main` deploy to Pages. The repo's **Settings → Pages →
+  Source** must be set to **GitHub Actions** (one-time).
+
 ## Architecture
 
 Start with [dev-docs/application_model.md](dev-docs/application_model.md)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-log
-Version: 1.3.0
+Version: 1.5.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
@@ -18,7 +18,7 @@ Requires-Dist: mistune>=3.1.4
 Requires-Dist: packaging>=25.0
 Requires-Dist: pydantic>=2.12.0
 Requires-Dist: pygments>=2.19.2
-Requires-Dist: textual==6.5.0
+Requires-Dist: textual>=6.5.0
 Requires-Dist: toml>=0.10.2
 Description-Content-Type: text/markdown
 
@@ -40,7 +40,7 @@ TUI demo:
 
 This tool generates clean, minimalist HTML pages showing user prompts and assistant responses chronologically. It's designed to create a readable log of your Claude Code interactions with support for both individual files and entire project hierarchies.
 
-📄 **[View Example HTML Output](https://github.com/daaain/claude-code-log/releases/latest/download/claude-code-log-transcript.html)** - Download a real example generated from this project's development (large file, ~100 MB)
+📄 **[View Example HTML Output](https://daaain.github.io/claude-code-log/example/)** - A real example generated from a sample of this project's development, regenerated on every docs build
 
 ## Quickstart
 
@@ -188,6 +188,21 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--compact` merges consecutive same-type sections in Markdown so runs of assistant responses share one heading instead of repeating `### 🤖 Assistant:` for each.
 
+### Linking Commit SHAs
+
+Plain `7c2e6f6`-shaped tokens in transcript prose get turned into clickable commit links when the SHA is reachable from a local remote-tracking branch. **github.com**, **gitlab.com**, and **bitbucket.org** work out of the box. For self-hosted forges (in-house GitLab, Gitea, Forgejo, …), supply a URL template via `--git-link`:
+
+```bash
+# Self-hosted GitLab
+claude-code-log /path/to/transcript --git-link 'https://{host}/{path}/-/commit/{sha}'
+
+# Same thing via env var (useful for TUI / repeated invocations)
+export CLAUDE_CODE_LOG_GIT_LINK='https://{host}/{path}/-/commit/{sha}'
+claude-code-log --tui
+```
+
+Placeholders: `{host}`, `{path}`, `{sha}`. The template fires only when the static map doesn't already know the host, so a mix of GitHub repos + self-hosted GitLab gets correct links from both. SHAs not reachable from any local remote-tracking ref render as plain text — local-only work-in-progress commits never produce broken links.
+
 ## Project Hierarchy Output
 
 When processing all projects, the tool generates:

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

@@ -16,7 +16,7 @@ TUI demo:
 
 This tool generates clean, minimalist HTML pages showing user prompts and assistant responses chronologically. It's designed to create a readable log of your Claude Code interactions with support for both individual files and entire project hierarchies.
 
-📄 **[View Example HTML Output](https://github.com/daaain/claude-code-log/releases/latest/download/claude-code-log-transcript.html)** - Download a real example generated from this project's development (large file, ~100 MB)
+📄 **[View Example HTML Output](https://daaain.github.io/claude-code-log/example/)** - A real example generated from a sample of this project's development, regenerated on every docs build
 
 ## Quickstart
 
@@ -164,6 +164,21 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--compact` merges consecutive same-type sections in Markdown so runs of assistant responses share one heading instead of repeating `### 🤖 Assistant:` for each.
 
+### Linking Commit SHAs
+
+Plain `7c2e6f6`-shaped tokens in transcript prose get turned into clickable commit links when the SHA is reachable from a local remote-tracking branch. **github.com**, **gitlab.com**, and **bitbucket.org** work out of the box. For self-hosted forges (in-house GitLab, Gitea, Forgejo, …), supply a URL template via `--git-link`:
+
+```bash
+# Self-hosted GitLab
+claude-code-log /path/to/transcript --git-link 'https://{host}/{path}/-/commit/{sha}'
+
+# Same thing via env var (useful for TUI / repeated invocations)
+export CLAUDE_CODE_LOG_GIT_LINK='https://{host}/{path}/-/commit/{sha}'
+claude-code-log --tui
+```
+
+Placeholders: `{host}`, `{path}`, `{sha}`. The template fires only when the static map doesn't already know the host, so a mix of GitHub repos + self-hosted GitLab gets correct links from both. SHAs not reachable from any local remote-tracking ref render as plain text — local-only work-in-progress commits never produce broken links.
+
 ## Project Hierarchy Output
 
 When processing all projects, the tool generates: