reclaimable 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. checksums.yaml +7 -0
  2. data/.claude/launch.json +11 -0
  3. data/.gitignore +11 -0
  4. data/.gitlab-ci.yml +16 -0
  5. data/AGENTS.md +88 -0
  6. data/CLAUDE.md +1 -0
  7. data/Gemfile +3 -0
  8. data/LICENSE +674 -0
  9. data/README.md +160 -0
  10. data/Rakefile +28 -0
  11. data/ai-skill/reclaimable/SKILL.md +94 -0
  12. data/benchmark/README.md +59 -0
  13. data/benchmark/experiments/lstat_scanner.rb +11 -0
  14. data/benchmark/experiments/ractor_scanner.rb +92 -0
  15. data/benchmark/experiments/verify_bulk_list.rb +34 -0
  16. data/benchmark/lib/fixture.rb +104 -0
  17. data/benchmark/lib/results.rb +62 -0
  18. data/benchmark/reports/00-baseline.md +75 -0
  19. data/benchmark/reports/01-jit.md +70 -0
  20. data/benchmark/reports/02-ractor.md +58 -0
  21. data/benchmark/reports/03-getattrlistbulk.md +84 -0
  22. data/benchmark/reports/04-others.md +52 -0
  23. data/benchmark/reports/05-outside-root.md +56 -0
  24. data/benchmark/reports/06-round2-discussion.md +374 -0
  25. data/benchmark/reports/06-round2.md +194 -0
  26. data/benchmark/reports/README.md +46 -0
  27. data/benchmark/results/baseline.yml +126 -0
  28. data/benchmark/results/bulk-list.yml +126 -0
  29. data/benchmark/results/final-yjit.yml +126 -0
  30. data/benchmark/results/final.yml +126 -0
  31. data/benchmark/results/ractor-exp.yml +38 -0
  32. data/benchmark/results/round2-after.yml +126 -0
  33. data/benchmark/results/round2-before.yml +126 -0
  34. data/benchmark/results/src-baseline.yml +32 -0
  35. data/benchmark/results/src-bulk-list.yml +32 -0
  36. data/benchmark/results/src-pair-none1.yml +38 -0
  37. data/benchmark/results/src-pair-none2.yml +38 -0
  38. data/benchmark/results/src-pair-yjit1.yml +38 -0
  39. data/benchmark/results/src-pair-yjit2.yml +38 -0
  40. data/benchmark/results/src-ractor-exp.yml +32 -0
  41. data/benchmark/results/src-round2-after1.yml +52 -0
  42. data/benchmark/results/src-round2-after2.yml +52 -0
  43. data/benchmark/results/src-round2-before1.yml +52 -0
  44. data/benchmark/results/src-round2-before2.yml +52 -0
  45. data/benchmark/results/yjit.yml +126 -0
  46. data/benchmark/results/zjit.yml +126 -0
  47. data/benchmark/run.rb +149 -0
  48. data/bin/reclaimable +10 -0
  49. data/doc/performance.md +179 -0
  50. data/lib/reclaimable/ai_skill.rb +138 -0
  51. data/lib/reclaimable/bulk_list.rb +91 -0
  52. data/lib/reclaimable/cache_dump.rb +125 -0
  53. data/lib/reclaimable/cli.rb +168 -0
  54. data/lib/reclaimable/cloud_files.rb +33 -0
  55. data/lib/reclaimable/config.rb +100 -0
  56. data/lib/reclaimable/i18n.rb +24 -0
  57. data/lib/reclaimable/locations.rb +89 -0
  58. data/lib/reclaimable/output.rb +154 -0
  59. data/lib/reclaimable/paths.rb +36 -0
  60. data/lib/reclaimable/report.rb +504 -0
  61. data/lib/reclaimable/ruby_abi.rb +69 -0
  62. data/lib/reclaimable/scan_cache.rb +97 -0
  63. data/lib/reclaimable/scanner.rb +440 -0
  64. data/lib/reclaimable/util.rb +34 -0
  65. data/lib/reclaimable.rb +42 -0
  66. data/locale/ja/LC_MESSAGES/reclaimable.mo +0 -0
  67. data/man/reclaimable.1.ronn +302 -0
  68. data/man/reclaimable.en.1 +234 -0
  69. data/man/reclaimable.ja.1 +452 -0
  70. data/po/ja/reclaimable-docs.po +668 -0
  71. data/po/ja/reclaimable.po +510 -0
  72. data/rakelib/benchmark.rake +22 -0
  73. data/rakelib/docs/japanese.rb +132 -0
  74. data/rakelib/docs/man_page.rb +73 -0
  75. data/rakelib/docs/site.rb +187 -0
  76. data/rakelib/docs/sources.rb +94 -0
  77. data/rakelib/docs/translation.rb +157 -0
  78. data/rakelib/docs.rake +62 -0
  79. data/rakelib/gettext.rake +30 -0
  80. data/rakelib/i18n.rake +199 -0
  81. data/reclaimable.gemspec +56 -0
  82. data/site/index.md +142 -0
  83. data/site/layout.html.erb +60 -0
  84. data/site/style.css +82 -0
  85. metadata +231 -0
@@ -0,0 +1,126 @@
1
+ ---
2
+ label: baseline
3
+ measured_at: '2026-11-16 05:36:35'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +PRISM [arm64-darwin27]
5
+ jit: none
6
+ scanner: Reclaimable::Scanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 5
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 2.788
16
+ - 2.7707
17
+ - 2.6965
18
+ - 2.6823
19
+ - 2.3723
20
+ user:
21
+ - 1.078
22
+ - 1.0639
23
+ - 1.0597
24
+ - 1.0717
25
+ - 1.1086
26
+ sys:
27
+ - 4.3481
28
+ - 4.4393
29
+ - 4.2079
30
+ - 4.4308
31
+ - 3.9385
32
+ scan (cached):
33
+ real:
34
+ - 0.2466
35
+ - 0.2457
36
+ - 0.2463
37
+ - 0.2464
38
+ - 0.2461
39
+ user:
40
+ - 0.1633
41
+ - 0.1624
42
+ - 0.1625
43
+ - 0.1635
44
+ - 0.1625
45
+ sys:
46
+ - 0.153
47
+ - 0.1523
48
+ - 0.1528
49
+ - 0.1511
50
+ - 0.1529
51
+ cache save:
52
+ real:
53
+ - 0.0762
54
+ - 0.0721
55
+ - 0.0716
56
+ - 0.0735
57
+ - 0.0722
58
+ user:
59
+ - 0.0738
60
+ - 0.0707
61
+ - 0.0704
62
+ - 0.072
63
+ - 0.0709
64
+ sys:
65
+ - 0.0022
66
+ - 0.0014
67
+ - 0.0012
68
+ - 0.0014
69
+ - 0.0013
70
+ cache load:
71
+ real:
72
+ - 0.0381
73
+ - 0.0329
74
+ - 0.0339
75
+ - 0.0344
76
+ - 0.0343
77
+ user:
78
+ - 0.0371
79
+ - 0.0323
80
+ - 0.0335
81
+ - 0.034
82
+ - 0.0337
83
+ sys:
84
+ - 0.0009
85
+ - 0.0005
86
+ - 0.0004
87
+ - 0.0003
88
+ - 0.0004
89
+ cache dump (json):
90
+ real:
91
+ - 0.1103
92
+ - 0.1077
93
+ - 0.1084
94
+ - 0.1076
95
+ - 0.1056
96
+ user:
97
+ - 0.1066
98
+ - 0.1055
99
+ - 0.1061
100
+ - 0.1055
101
+ - 0.1039
102
+ sys:
103
+ - 0.0032
104
+ - 0.0018
105
+ - 0.0018
106
+ - 0.0019
107
+ - 0.0016
108
+ startup (--help):
109
+ real:
110
+ - 0.2328
111
+ - 0.1506
112
+ - 0.1495
113
+ - 0.1473
114
+ - 0.1431
115
+ user:
116
+ - 0.1085
117
+ - 0.1096
118
+ - 0.1082
119
+ - 0.1069
120
+ - 0.1046
121
+ sys:
122
+ - 0.0573
123
+ - 0.0369
124
+ - 0.037
125
+ - 0.0363
126
+ - 0.0351
@@ -0,0 +1,126 @@
1
+ ---
2
+ label: bulk-list
3
+ measured_at: '2026-11-16 05:58:15'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +PRISM [arm64-darwin27]
5
+ jit: none
6
+ scanner: Reclaimable::Scanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 5
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 1.0701
16
+ - 1.0388
17
+ - 1.0314
18
+ - 1.0512
19
+ - 1.0285
20
+ user:
21
+ - 0.6576
22
+ - 0.6291
23
+ - 0.6176
24
+ - 0.6388
25
+ - 0.6244
26
+ sys:
27
+ - 1.8631
28
+ - 1.9262
29
+ - 1.8372
30
+ - 1.8567
31
+ - 1.8504
32
+ scan (cached):
33
+ real:
34
+ - 0.2433
35
+ - 0.2436
36
+ - 0.2422
37
+ - 0.2426
38
+ - 0.2424
39
+ user:
40
+ - 0.1664
41
+ - 0.1666
42
+ - 0.1656
43
+ - 0.1657
44
+ - 0.1655
45
+ sys:
46
+ - 0.1386
47
+ - 0.1385
48
+ - 0.138
49
+ - 0.1381
50
+ - 0.1384
51
+ cache save:
52
+ real:
53
+ - 0.0686
54
+ - 0.0682
55
+ - 0.0679
56
+ - 0.0677
57
+ - 0.0706
58
+ user:
59
+ - 0.0666
60
+ - 0.0664
61
+ - 0.0667
62
+ - 0.0665
63
+ - 0.0694
64
+ sys:
65
+ - 0.002
66
+ - 0.0016
67
+ - 0.0012
68
+ - 0.0012
69
+ - 0.0012
70
+ cache load:
71
+ real:
72
+ - 0.0373
73
+ - 0.0303
74
+ - 0.0285
75
+ - 0.0284
76
+ - 0.0295
77
+ user:
78
+ - 0.0363
79
+ - 0.0298
80
+ - 0.0282
81
+ - 0.0281
82
+ - 0.0292
83
+ sys:
84
+ - 0.001
85
+ - 0.0006
86
+ - 0.0003
87
+ - 0.0003
88
+ - 0.0003
89
+ cache dump (json):
90
+ real:
91
+ - 0.1045
92
+ - 0.0996
93
+ - 0.0997
94
+ - 0.1005
95
+ - 0.1132
96
+ user:
97
+ - 0.0991
98
+ - 0.098
99
+ - 0.0983
100
+ - 0.099
101
+ - 0.1087
102
+ sys:
103
+ - 0.0052
104
+ - 0.0016
105
+ - 0.0014
106
+ - 0.0015
107
+ - 0.0044
108
+ startup (--help):
109
+ real:
110
+ - 0.1475
111
+ - 0.138
112
+ - 0.1374
113
+ - 0.1436
114
+ - 0.1388
115
+ user:
116
+ - 0.1017
117
+ - 0.1007
118
+ - 0.1005
119
+ - 0.1043
120
+ - 0.101
121
+ sys:
122
+ - 0.0413
123
+ - 0.0339
124
+ - 0.0333
125
+ - 0.0354
126
+ - 0.0342
@@ -0,0 +1,126 @@
1
+ ---
2
+ label: final-yjit
3
+ measured_at: '2026-11-16 06:19:51'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +YJIT +PRISM [arm64-darwin27]
5
+ jit: yjit
6
+ scanner: Reclaimable::Scanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 5
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 1.048
16
+ - 0.9839
17
+ - 1.2842
18
+ - 1.0937
19
+ - 1.0408
20
+ user:
21
+ - 0.597
22
+ - 0.5506
23
+ - 0.709
24
+ - 0.6142
25
+ - 0.575
26
+ sys:
27
+ - 2.0911
28
+ - 1.9967
29
+ - 2.6855
30
+ - 2.2532
31
+ - 2.151
32
+ scan (cached):
33
+ real:
34
+ - 0.1888
35
+ - 0.1857
36
+ - 0.1822
37
+ - 0.1813
38
+ - 0.1806
39
+ user:
40
+ - 0.1217
41
+ - 0.1178
42
+ - 0.1159
43
+ - 0.1151
44
+ - 0.1147
45
+ sys:
46
+ - 0.124
47
+ - 0.1245
48
+ - 0.1219
49
+ - 0.1218
50
+ - 0.121
51
+ cache save:
52
+ real:
53
+ - 0.0426
54
+ - 0.042
55
+ - 0.0412
56
+ - 0.0419
57
+ - 0.0416
58
+ user:
59
+ - 0.0404
60
+ - 0.0403
61
+ - 0.0394
62
+ - 0.0404
63
+ - 0.0401
64
+ sys:
65
+ - 0.0021
66
+ - 0.0017
67
+ - 0.0015
68
+ - 0.0015
69
+ - 0.0015
70
+ cache load:
71
+ real:
72
+ - 0.0354
73
+ - 0.0303
74
+ - 0.0303
75
+ - 0.032
76
+ - 0.0295
77
+ user:
78
+ - 0.0344
79
+ - 0.0294
80
+ - 0.0299
81
+ - 0.0312
82
+ - 0.0291
83
+ sys:
84
+ - 0.001
85
+ - 0.0009
86
+ - 0.0004
87
+ - 0.0008
88
+ - 0.0004
89
+ cache dump (json):
90
+ real:
91
+ - 0.1006
92
+ - 0.1044
93
+ - 0.1108
94
+ - 0.0935
95
+ - 0.1043
96
+ user:
97
+ - 0.0951
98
+ - 0.1009
99
+ - 0.1018
100
+ - 0.092
101
+ - 0.1012
102
+ sys:
103
+ - 0.0055
104
+ - 0.0035
105
+ - 0.0024
106
+ - 0.0015
107
+ - 0.0031
108
+ startup (--help):
109
+ real:
110
+ - 0.1533
111
+ - 0.1483
112
+ - 0.1562
113
+ - 0.1672
114
+ - 0.1637
115
+ user:
116
+ - 0.1092
117
+ - 0.1088
118
+ - 0.1122
119
+ - 0.1197
120
+ - 0.1203
121
+ sys:
122
+ - 0.0402
123
+ - 0.0353
124
+ - 0.0397
125
+ - 0.04
126
+ - 0.0397
@@ -0,0 +1,126 @@
1
+ ---
2
+ label: final
3
+ measured_at: '2026-11-16 06:19:38'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +PRISM [arm64-darwin27]
5
+ jit: none
6
+ scanner: Reclaimable::Scanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 5
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 1.1986
16
+ - 1.4218
17
+ - 1.1302
18
+ - 1.3893
19
+ - 1.1357
20
+ user:
21
+ - 0.7331
22
+ - 0.8415
23
+ - 0.6797
24
+ - 0.8303
25
+ - 0.684
26
+ sys:
27
+ - 2.2165
28
+ - 2.6433
29
+ - 2.038
30
+ - 2.5934
31
+ - 2.1002
32
+ scan (cached):
33
+ real:
34
+ - 0.2418
35
+ - 0.2284
36
+ - 0.2144
37
+ - 0.2166
38
+ - 0.209
39
+ user:
40
+ - 0.1633
41
+ - 0.1553
42
+ - 0.1462
43
+ - 0.1472
44
+ - 0.1419
45
+ sys:
46
+ - 0.1402
47
+ - 0.1317
48
+ - 0.1236
49
+ - 0.1261
50
+ - 0.1219
51
+ cache save:
52
+ real:
53
+ - 0.0425
54
+ - 0.0418
55
+ - 0.0411
56
+ - 0.0407
57
+ - 0.0414
58
+ user:
59
+ - 0.0403
60
+ - 0.0402
61
+ - 0.0398
62
+ - 0.0395
63
+ - 0.0401
64
+ sys:
65
+ - 0.0022
66
+ - 0.0015
67
+ - 0.0013
68
+ - 0.0013
69
+ - 0.0013
70
+ cache load:
71
+ real:
72
+ - 0.0351
73
+ - 0.0307
74
+ - 0.0304
75
+ - 0.0311
76
+ - 0.0299
77
+ user:
78
+ - 0.0338
79
+ - 0.0294
80
+ - 0.0299
81
+ - 0.0303
82
+ - 0.0295
83
+ sys:
84
+ - 0.0013
85
+ - 0.0013
86
+ - 0.0005
87
+ - 0.0007
88
+ - 0.0004
89
+ cache dump (json):
90
+ real:
91
+ - 0.1051
92
+ - 0.1027
93
+ - 0.101
94
+ - 0.0997
95
+ - 0.0987
96
+ user:
97
+ - 0.0987
98
+ - 0.0994
99
+ - 0.0986
100
+ - 0.0978
101
+ - 0.0963
102
+ sys:
103
+ - 0.0057
104
+ - 0.0034
105
+ - 0.0024
106
+ - 0.0019
107
+ - 0.0024
108
+ startup (--help):
109
+ real:
110
+ - 0.19
111
+ - 0.1359
112
+ - 0.1368
113
+ - 0.1408
114
+ - 0.1538
115
+ user:
116
+ - 0.1046
117
+ - 0.0998
118
+ - 0.1001
119
+ - 0.1018
120
+ - 0.1065
121
+ sys:
122
+ - 0.0438
123
+ - 0.0328
124
+ - 0.0333
125
+ - 0.0341
126
+ - 0.0403
@@ -0,0 +1,38 @@
1
+ ---
2
+ label: ractor-exp
3
+ measured_at: '2026-11-16 05:48:00'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +PRISM [arm64-darwin27]
5
+ jit: none
6
+ scanner: Reclaimable::RactorScanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 3
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 1.2109
16
+ - 1.19
17
+ - 1.1876
18
+ user:
19
+ - 1.1266
20
+ - 1.1765
21
+ - 1.1481
22
+ sys:
23
+ - 4.9424
24
+ - 5.2993
25
+ - 5.1145
26
+ scan (cached):
27
+ real:
28
+ - 0.0857
29
+ - 0.067
30
+ - 0.0684
31
+ user:
32
+ - 0.1835
33
+ - 0.1513
34
+ - 0.1538
35
+ sys:
36
+ - 0.2252
37
+ - 0.157
38
+ - 0.1696
@@ -0,0 +1,126 @@
1
+ ---
2
+ label: round2-after
3
+ measured_at: '2026-11-16 17:58:55'
4
+ ruby: ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +YJIT +PRISM [arm64-darwin27]
5
+ jit: yjit
6
+ scanner: Reclaimable::Scanner
7
+ root: "/Users/kitaitimakoto/src/gitlab.com/KitaitiMakoto/reclaimable/tmp/benchmark/fixture"
8
+ jobs: 8
9
+ reps: 5
10
+ dirs: 30321
11
+ total_bytes: 887324672
12
+ scenarios:
13
+ scan (no cache):
14
+ real:
15
+ - 0.9195
16
+ - 0.9133
17
+ - 0.8984
18
+ - 0.9023
19
+ - 0.8952
20
+ user:
21
+ - 0.5019
22
+ - 0.4949
23
+ - 0.4857
24
+ - 0.488
25
+ - 0.483
26
+ sys:
27
+ - 1.9148
28
+ - 1.9081
29
+ - 1.8602
30
+ - 1.8613
31
+ - 1.8655
32
+ scan (cached):
33
+ real:
34
+ - 0.1951
35
+ - 0.1932
36
+ - 0.1932
37
+ - 0.1944
38
+ - 0.1935
39
+ user:
40
+ - 0.1209
41
+ - 0.1194
42
+ - 0.1199
43
+ - 0.1201
44
+ - 0.1198
45
+ sys:
46
+ - 0.1371
47
+ - 0.1365
48
+ - 0.1361
49
+ - 0.1381
50
+ - 0.1371
51
+ cache save:
52
+ real:
53
+ - 0.0139
54
+ - 0.0132
55
+ - 0.0131
56
+ - 0.0138
57
+ - 0.0136
58
+ user:
59
+ - 0.0133
60
+ - 0.0129
61
+ - 0.0128
62
+ - 0.0129
63
+ - 0.0128
64
+ sys:
65
+ - 0.0006
66
+ - 0.0003
67
+ - 0.0003
68
+ - 0.0004
69
+ - 0.0004
70
+ cache load:
71
+ real:
72
+ - 0.0109
73
+ - 0.0105
74
+ - 0.0106
75
+ - 0.0104
76
+ - 0.0104
77
+ user:
78
+ - 0.0105
79
+ - 0.0104
80
+ - 0.0105
81
+ - 0.0103
82
+ - 0.0103
83
+ sys:
84
+ - 0.0004
85
+ - 0.0001
86
+ - 0.0002
87
+ - 0.0001
88
+ - 0.0001
89
+ cache dump (json):
90
+ real:
91
+ - 0.1111
92
+ - 0.0989
93
+ - 0.0985
94
+ - 0.0981
95
+ - 0.1011
96
+ user:
97
+ - 0.108
98
+ - 0.0973
99
+ - 0.0972
100
+ - 0.0961
101
+ - 0.0991
102
+ sys:
103
+ - 0.0031
104
+ - 0.0015
105
+ - 0.0012
106
+ - 0.002
107
+ - 0.002
108
+ startup (--help):
109
+ real:
110
+ - 0.1564
111
+ - 0.1503
112
+ - 0.1462
113
+ - 0.1648
114
+ - 0.1458
115
+ user:
116
+ - 0.109
117
+ - 0.1107
118
+ - 0.1077
119
+ - 0.1176
120
+ - 0.108
121
+ sys:
122
+ - 0.0419
123
+ - 0.0359
124
+ - 0.0351
125
+ - 0.0398
126
+ - 0.0346