Skip to content

Commit b95307c

Browse files
kylehowellsclaude
kylehowells
and
claude
committed
Organize performance reports with dates, commits, and ordered names
Performance reports now include commit hashes and timestamps, and are renamed with numeric prefixes for chronological ordering: 1. 01-PerformanceInvestigationPlan.md (a471c13, 08:52) - Initial 308ms plan 2. 02-PerformanceInvestigationReport.md (0c0ee00, 09:20) - Failed "easy wins" 3. 03-TurboOptimizationPlan.md (887bea9, 09:34) - Aggressive optimization plan 4. 04-ProfilingReport.md (a6296ac, 12:38) - Mid-optimization 171ms snapshot 5. 05-OptimizationHistory.md (195a0c4, 14:48) - Full journey 302ms → 97ms 6. 06-PerformanceProfile.md (e649e30, 14:58) - Final 98ms breakdown Also updated DocC documentation links to new filenames. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent aafbb8c commit b95307c

File tree

8 files changed

+21
-11
lines changed

8 files changed

+21
-11
lines changed

‎Sources/swift-justhtml/Documentation.docc/Performance.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -168,5 +168,5 @@ Swift's remaining overhead is primarily:
168168
## See Also
169169

170170
- <doc:Benchmarking>
171-
- [OPTIMIZATION_HISTORY.md](https://github.com/kylehowells/swift-justhtml/blob/master/notes/OPTIMIZATION_HISTORY.md)
172-
- [PERFORMANCE_PROFILE.md](https://github.com/kylehowells/swift-justhtml/blob/master/notes/PERFORMANCE_PROFILE.md)
171+
- [Optimization History](https://github.com/kylehowells/swift-justhtml/blob/master/notes/05-OptimizationHistory.md)
172+
- [Performance Profile](https://github.com/kylehowells/swift-justhtml/blob/master/notes/06-PerformanceProfile.md)

notes/PERFORMANCE_INVESTIGATION_PLAN.md renamed to notes/01-PerformanceInvestigationPlan.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Performance Investigation Plan: Swift vs JavaScript
22

3+
**Commit:** `a471c13`
4+
**Date:** 2025-12-17 08:52:20 UTC
5+
**Baseline:** 308ms (2.9x slower than JavaScript)
6+
37
## Executive Summary
48

59
The swift-justhtml implementation is **2.9x slower** than the JavaScript implementation:

notes/PERFORMANCE_INVESTIGATION_REPORT.md renamed to notes/02-PerformanceInvestigationReport.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Performance Investigation Report: swift-justhtml
22

3-
**Date:** December 17, 2025
4-
**Investigator:** Claude Code
5-
**Version:** swift-justhtml master branch
3+
**Commit:** `0c0ee00`
4+
**Date:** 2025-12-17 09:20:17 UTC
5+
**Result:** 307ms (Easy wins failed - only 1.2% improvement)
66

77
---
88

notes/TURBO_OPTIMIZATION_PLAN.md renamed to notes/03-TurboOptimizationPlan.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Turbo Optimization Plan
22

3+
**Commit:** `887bea9`
4+
**Date:** 2025-12-17 09:34:00 UTC
5+
**Status:** Tracking optimizations from 302ms → 173ms
6+
37
**Goal:** Match or beat JavaScript implementation speed (108ms) while maintaining 100% test pass rate.
48

59
**Current State:**

notes/PROFILING_REPORT.md renamed to notes/04-ProfilingReport.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Swift JustHTML Performance Profiling Report
22

3-
**Generated:** 2025-12-17
4-
**Version:** turbo branch (with TagID optimizations)
5-
**Total Parse Time:** 171 ms (2.54 MB of HTML)
3+
**Commit:** `a6296ac`
4+
**Date:** 2025-12-17 12:38:51 UTC
5+
**Total Parse Time:** 171ms (mid-optimization snapshot)
66

77
---
88

notes/OPTIMIZATION_HISTORY.md renamed to notes/05-OptimizationHistory.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Swift JustHTML Performance Optimization History
22

3+
**Commit:** `195a0c4`
4+
**Date:** 2025-12-17 14:48:19 UTC
35
**Final Result:** 302ms → 97ms (**3.1x faster**, 68% reduction)
46

57
This document details all performance optimizations made to the Swift JustHTML parser on the `turbo` branch, achieving performance parity with JavaScript (parse5).

notes/PERFORMANCE_PROFILE.md renamed to notes/06-PerformanceProfile.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Swift JustHTML Performance Profile
22

3-
**Generated:** 2025-12-17
4-
**Version:** turbo branch (commit 195a0c4)
5-
**Total Benchmark Time:** 98ms (all test files)
3+
**Commit:** `e649e30`
4+
**Date:** 2025-12-17 14:58:17 UTC
5+
**Total Benchmark Time:** 98ms (final optimized version)
66
**Primary Test File:** wikipedia_ww2.html (1,204 KB)
77

88
---

notes/PERFORMANCE_INSIGHTS.md renamed to notes/PerformanceInsights.md

File renamed without changes.

0 commit comments

Comments
 (0)