Skip to content

refactor(comments): trim verbose comments across the codebase - #1360

Merged
TheGreatAxios merged 259 commits into
corbitsdev:mainfrom
Gustav-Simonsson:improve_code_comments
Oct 11, 2026
Merged

TheGreatAxios merged 259 commits into
corbitsdev:mainfrom
Gustav-Simonsson:improve_code_comments

Conversation

@Gustav-Simonsson

Copy link
Copy Markdown
Contributor

Summary

256 commits of code comment edits.

No source code changed.

Each commit makes one or more code comments simpler and shorter. In several cases correctness was also improved by removing e.g. stale references.

In total 6,896 lines of code comments are removed. These lines contained 449,160 chars, or roughly 112k LLM tokens.

All tracked files in corbits-code (no node_modules) total ~14.1M chars, about 3.5M tokens. The PR's net removal of ~112k tokens means an LLM reading every file in the repo parses roughly 3% fewer tokens than before.

Commits

Commit LoC Chars Description
cd041526 -232 -7819 refactor(permission): trim verbose comments and drop stale ticket refs
33b81a97 -197 -9049 refactor(agent): trim verbose comments and drop stale ticket refs
4a19083a -83 -2556 refactor(session): trim verbose comments and drop stale ticket refs
4a38fc5e -17 -1402 refactor(plugins): trim verbose comments and drop stale ticket refs
8fb8c66b -52 -4069 refactor(tui): trim verbose comments and drop stale ticket refs
9360665e -33 -1952 refactor(config): trim verbose comments and drop stale ticket refs
05344dea -28 -983 refactor(perf): trim verbose comments and drop stale ticket refs
b97839af -70 -2933 refactor(tui): trim verbose comments in remaining files
cfcebbf9 -30 -732 refactor(telemetry): trim verbose comments and drop stale ticket refs
f5465adf -30 -1572 refactor(src): trim verbose comments and drop stale ticket refs
08b61793 -47 -1504 refactor(subagent): trim verbose comments and drop stale ticket refs
2746e5b4 -139 -1795 refactor(src): trim verbose comments and drop stale ticket refs in root files
9d98b5e3 -17 -828 refactor(scripts): trim verbose comments and drop stale ticket refs
7f64b7f3 -118 -3840 refactor(e2e): trim verbose comments and drop stale ticket refs
4d1652f6 -96 -3348 refactor(shell): trim verbose comments
9fbe5164 -47 -760 refactor(evals): trim verbose comments and drop stale ticket refs
0a122c9e -78 -3976 refactor(subagent): trim verbose comments in remaining files
4a5ed21f -82 -5631 refactor(tui): trim verbose comments in remaining files
d83eb3b3 -13 -1048 refactor(packages): trim verbose comments and drop stale ticket refs
f9166f12 -31 -1322 refactor(tui): trim verbose comments in untouched files
f92aa457 -44 -1489 refactor(comments): trim verbose comments in the last untrimmed files
9e80665d -28 -2048 refactor(tui): compress the largest remaining comment pools
9e918b47 -17 -961 refactor(tui): compress the deepest remaining comment pool
dd06e3d9 -58 -3775 refactor(tui): compress the last shallow-pass comment pools
f0210586 -19 -1140 refactor(plugins): trim verbose comments in remaining files
f9bfadaf -22 -1369 refactor(comments): trim verbose comments in the last untouched files
89a8e1f3 -146 -1653 refactor(tui): compress the largest shallow-pass comment pools
db7466f7 -36 -919 refactor(subagent): compress verbose session and fleet comments
674905cb -90 -3478 refactor(tui): compress the last shallow-pass comment pools
99567389 -64 -4416 refactor(comments): compress the most verbose remaining comment pools
444cb14f -24 -1372 refactor(comments): compress the last high-verbosity comment pools
b8e69bc0 -167 -2353 refactor(tui): compress the largest remaining comment pool
d5c08340 -5 -914 refactor(config): compress verbose comments in settings and catalog
b3e23bd9 -10 -1371 refactor(tui): compress verbose comments in shell internals
6413d609 -58 -273 refactor(tui): compress verbose comments in shell chrome
e5e9c91c -52 -70 refactor(agent): compress verbose comments in the chat director
1eeb7f90 -12 300 refactor(permission): compress verbose comments in the permission gate
0140810c -30 -246 refactor(plugins): compress verbose comments in the plugin loader
d078c88e -53 -493 refactor(session): compress verbose comments in the compactor
faa96550 -34 -3009 refactor(permission): compress verbose comments in the permission test
fb845c09 -20 -1299 refactor(agent): compress verbose comments in the agent toolset
34e074c7 -33 0 refactor(tui): compress verbose comments in the runner lifecycle
c1cfaf18 -54 -1590 refactor(subagent): compress verbose comments in the session store
dec189c0 -19 -1236 refactor(session): compress verbose comments in runtime assembly
2150f0b7 -125 -2821 refactor(tui): compress verbose comments in the runtime bridge
9c2b1435 -25 -1645 refactor(permission): compress verbose comments in the classifier
d05dba3f -35 0 refactor(subagent): compress verbose comments in the run lifecycle
a040cee0 -33 -1294 refactor(tui): compress verbose comments in the chrome state
372229cc -21 -1769 refactor(subagent): compress verbose doc comments in shared types
61ec62fa -28 -517 refactor(exec): compress verbose comments in the exec runner
4dcc0423 -42 -1444 refactor(auth): compress verbose comments in the credential store
ff3f107a -12 -863 refactor(permission): compress verbose comments in the security classify test
d4c2c2cf -10 -116 refactor(agent): compress verbose comments in the codex apply patch parser
60e11ee0 -163 -1998 refactor(tui): deepen comment compression in shell internals
b7aa6d99 -28 -1272 refactor(mcp): compress verbose comments in the oauth provider and auth store
ead3b2b4 -106 -1546 refactor(tui): compress verbose comments in the stream row model
efdf85bb -30 -1238 refactor(shell): compress verbose comments in the shell authz policy
61963213 -35 -622 refactor(subagent): compress verbose comments in the fleet dispatch
a8676687 -48 -3576 refactor(agent): compress verbose comments in the compaction governor
b9d3f8aa -29 -427 refactor(telemetry): compress verbose comments in the telemetry module
0a610a28 -8 0 refactor(tui): compress verbose comments in the shell prompt
18aa3270 -22 -1389 refactor(provider): compress verbose comments in the provider module
0fd22e4b -26 -1380 refactor(subagent): compress verbose comments in the nudge director
a578afbf -18 -6 refactor(tui): compress verbose comments in the shell palette
6af53567 -14 -798 refactor(tui): compress verbose comments in the shell key routing
44daf15f -1 -24 refactor(tui): deepen comment compression in the shell chrome
69182cd0 -24 -993 refactor(agent): compress verbose comments in tool search and landing test
b4b9df90 -42 0 refactor(tui): compress verbose comments in the product host
a69ade3f -19 -811 refactor(tui): compress verbose comments in the geometry zone registry
734da3e6 -14 -1126 refactor(plugins): compress verbose comments in the data-only agent loader
73c00f76 -5 -429 refactor(workflows): compress verbose comments in the workflow host
87e19ce4 -77 -1734 refactor(tui): compress verbose comments in the transcript
64d9b753 -21 -1488 refactor(plugins): deepen comment compression in the secret guard plugin
34ae1e66 -39 -943 refactor(tui): deepen comment compression in the turn state
bb532f85 -21 -789 refactor(subagent): deepen comment compression in the session store
9df04ad2 -38 -1514 refactor(tui): deepen comment compression in the markdown parser
58177467 -38 -1953 refactor(config): deepen comment compression in the settings catalog
633e926d -23 -237 refactor(tui): deepen comment compression in the gate wire
5969aa1f -53 -416 refactor(subagent): deepen comment compression in the run lifecycle
fbdc18cc -53 -1671 refactor(tui): compress verbose comments in the runner wiring
fbbc7739 -9 -69 refactor(agent): compress verbose comments in the director test
308e636b -23 -816 refactor(permission): compress verbose comments in the module leftovers
d7c1bf0b -22 -1249 refactor(permission): compress verbose comments in the permission gate
b50a6dfa -9 -330 refactor(tui): compress verbose comments in the command surfaces
a13f5ade -20 -799 refactor(perf): compress verbose comments in the module leftovers
e8acb3f5 -26 -184 refactor(trust): compress verbose comments in the project trust store
83e9cc07 -26 -1204 refactor(tui): compress verbose comments in the last untouched files
3fc688f4 -30 -39 refactor(tui): deepen comment compression in the shell chrome
3e226026 -11 -580 refactor(agent): compress verbose comments in the module leftovers
ec3edaf6 -10 -162 refactor(subagent): deepen comment compression in the session store
a38748dd -6 -152 refactor(src): compress verbose comments in the gateway error module
bf8fa7b6 -23 -474 refactor(tui): compress verbose comments in the diff module
9388ef74 -42 -2807 refactor(tui): deepen comment compression in the shell internals
2bd06c99 -24 -1025 refactor(tui): compress verbose comments in the session start
b08d5410 -14 -191 refactor(subagent): deepen comment compression in the fleet dispatch
3adc415f -30 -484 refactor(permission): compress verbose comments in the worker grant module
112c5ccb -23 -963 refactor(session): compress verbose comments in the compaction handoff
3dc17a82 -6 -453 refactor(tools): compress verbose comments in the ssrf guard
db8b9c13 -34 -549 refactor(tui): deepen comment compression in the shell chrome
7c360a6f -12 -205 refactor(session): compress verbose comments in the summarizer
2da1b15a -79 -3423 refactor(tui): compress verbose comments in the provider setup module
48595592 -92 -1264 refactor(evals): compress verbose comments in the capability eval suite
d7b03431 -52 -164 refactor(agent): deepen comment compression in the chat director
04363d5e -13 -1338 refactor(tui): compress verbose comments in the shell key routing
690e2bab -10 -811 refactor(tui): compress verbose comments in the runner module
308d9e1e -72 -2677 refactor(scripts): compress verbose comments in the dev tooling
fc04a856 -32 -1492 refactor(tui): compress verbose comments in the theme palette
0b276c0b -15 -621 refactor(agent): deepen comment compression in the compaction governor
70b8d337 -21 -1380 refactor(tui): compress verbose comments in the remaining test files
70dbfb72 -16 -918 refactor(plugins): compress verbose comments in the remaining files
63300adb -83 -2255 refactor(subagent): compress verbose comments in the remaining files
fa826548 -70 -1689 refactor(session): compress verbose comments in the remaining files
b2000111 -24 -480 refactor(tui): compress verbose comments in the overlay host
86a4e562 -36 -2373 refactor(tui): compress verbose comments in the shell internals
6a400601 -11 -301 refactor(plugins): deepen comment compression in the plugin loader
15a303d0 -52 -1103 refactor(session): compress verbose comments in the runtime assembly
d77532f7 -38 -497 refactor(tui): compress verbose comments in the tool lane renderers
8a413cc3 -33 -2192 refactor(tui): compress verbose comments in the stall watchdog
0bf4778f -41 -2603 refactor(agent): compress verbose comments in the model family policy
0cbd4ce1 -12 -728 refactor(subagent): deepen comment compression in the shared types
ccaeb828 -19 -1411 refactor(permission): compress verbose comments in the command and path restriction cluster
bab58796 -7 -806 refactor(permission): compress verbose comments in the auto-mode shell policy cluster
fa7ef628 -11 -485 refactor(testkit): compress verbose comments in the shared test helpers
6f0044c0 -108 -2153 refactor(tui): compress the last shallow-trimmed comment pools
0a5231d2 -18 -153 refactor(plugins): compress verbose comments in the shell-guard plugin
68486008 141 339 refactor(comments): wrap overlong comment lines to standard width
5a91b8c7 -20 -302 refactor(tui): compress verbose comments in the transcript row pipeline
b1f9d0b9 -11 -860 refactor(tui): compress verbose comments in the tool execution watchdog
0cb258b5 -18 -1346 refactor(tui): compress verbose comments in the landing-animation primitives
9fca7e9a -23 -615 refactor(tui): compress verbose comments in the app shell assembly
84c5d337 -26 -1278 refactor(tui): compress verbose comments in the transcript stream rows
d747a1b9 -21 -627 refactor(tui): compress verbose comments in the agent progress lanes
27570109 -25 -1880 refactor(permission): compress verbose comments in the approval store cluster
656ddf36 -18 -1316 refactor(tui): compress verbose comments in the url link cluster
39df5c40 -5 -568 refactor(tui): compress verbose comments in the turn state
64b45403 -38 -2675 refactor(plugins): compress verbose comments in the truncation cluster
6f605d8d -26 -1515 refactor(subagent): compress verbose comments in the fleet lifecycle
626db33b -20 -1463 refactor(provider): compress verbose comments in the reasoning effort module
cbc33790 -9 -359 refactor(tui): deepen comment compression in the shell internals and test
e0b28ff0 -19 -1244 refactor(session): compress verbose comments in the sink and verify lifecycle
ffc94fcc -11 -580 refactor(config): compress verbose comments in the provider catalog and tests
4ab4c930 -68 -3565 refactor(perf): compress verbose comments in the perf trace cluster
f15c1ef2 -25 -863 refactor(tui): deepen comment compression in the provider setup cluster
2aa0bcae -24 -894 refactor(tui): compress verbose comments in the shallow-trimmed pools
ec28bf91 -43 -1746 refactor(auth): compress verbose comments in the callback and refresh lock
118459a1 -13 -896 refactor(workflows): compress verbose comments in the workflow cluster
58d78d12 -23 -943 refactor(tui): deepen comment compression in the runner module
bcaf6a27 -15 -866 refactor(agent): compress verbose comments in the toolset cluster
878fc12d -1 -266 refactor(tui): deepen comment compression in the runner host
2bee9403 -124 -4545 refactor(subagent): deepen comment compression in the fleet cluster
ca5a643e -57 -498 refactor(tui): compress verbose comments in the chrome state
0bea64e4 -11 -904 refactor(tui): deepen comment compression in the turn state
459bf792 -19 -589 refactor(tui): compress verbose comments in the zone registry
0356a977 -7 -356 refactor(session): compress verbose comments in the shallow-trimmed pools
111eb901 -14 -302 refactor(plugins): compress verbose comments in the diagnostics cluster
d6df5603 -24 -2373 refactor(tui): compress the largest remaining comment blocks
000234bf -22 -1771 refactor(tui): compress the last never-compressed files
951adcbf -21 -539 refactor: compress verbose comments in shell and session state
c7bed93c -44 -2315 refactor(agent): compress verbose comments in the tool taxonomy cluster
5d497f24 -17 -216 refactor(tui): compress verbose comments in the shell prompt box
de91f3a4 -36 -233 refactor(tui): compress verbose comments in the decision overlay body
78cfbd13 -38 -284 refactor(tui): compress verbose comments in the landing cluster
6e9bf0c4 -14 -319 refactor(trust): compress verbose comments in the path trust cluster
b85eaf6f -4 -10 refactor(tui): compress verbose comments in the shell chrome
34f38ec1 -11 -87 refactor(src): compress verbose comments in the gateway error module
ebf88d94 -14 -986 refactor(config): compress verbose comments in the settings catalog cluster
b4e48d9a -69 -834 refactor(tui): compress verbose comments in the tool lane cluster
8200ae8a -11 -357 refactor(tui): compress verbose comments in the overlay view
1aac9cc1 -3 -119 refactor(subagent): compress verbose comments in the run lifecycle
6d9ec5f1 -26 -411 refactor(permission): compress verbose comments in the authz cluster
dc62ac2e -20 -54 refactor(tui): deepen comment compression in the shell palette
2abdc4ec -18 -804 refactor(tui): compress verbose comments in the session bridge
0d3dc5c1 -5 -7 refactor(tui): deepen comment compression in the product host
bf945e76 -24 -49 refactor(subagent): compress verbose comments in the session store
7d4e59c1 -9 -318 refactor(tui): compress verbose comments in the prompt border
a866c562 -1 -252 refactor(tui): compress verbose comments in the delivery queue
7f996b53 -7 -351 refactor(tui): compress verbose comments in the overlay host cluster
80861d2b -18 -994 refactor(session): compress verbose comments in the runtime assembly cluster
ba83c309 -1 -353 refactor(tui): compress verbose comments in the shell internals
2556d059 -4 -2 refactor(tui): compress verbose comments in the shell chrome
988b0bdd -17 -1128 refactor(tui): deepen comment compression in the session bridge
9162cfda -5 -306 refactor(tui): compress verbose comments in the chrome state
c0405d43 -29 -898 refactor(tui): compress verbose comments in the markdown parser
81f4d6f0 -23 -958 refactor(tui): deepen comment compression in the mark animation primitives
8946a0ca 0 -22 refactor(trust): deepen comment compression in the trust stores
8ba779cc -8 -609 refactor(tui): compress verbose comments in the url link cluster
a121170e -6 -791 refactor(subagent): compress verbose comments in the fleet dispatch cluster
0a3672c7 -10 -247 refactor(session): compress verbose comments in the compaction persistence cluster
3ba057ce -3 -271 refactor(tui): deepen comment compression in the agent progress lanes
64f3e5fa -4 -346 refactor(tui): deepen comment compression in the wrapped link splitter
2fd7c2d8 -3 -138 refactor(subagent): compress verbose comments in the shell child reap tests
27583f8d -4 -126 refactor(tui): compress verbose comments in the chrome state
ef6a302a -2 -266 refactor(tui): deepen comment compression in the tool execution watchdog
7bd2fb26 -4 -613 refactor(mcp): compress verbose comments in the client and its telemetry tests
296ebd74 -17 -717 refactor(tui): compress verbose comments in the theme cluster
76406bea -14 -703 refactor(tui): compress verbose comments in the prompt keybinding cluster
2e9ec1ff -9 -617 refactor: compress the largest remaining comment blocks
091bc3f5 6 -108 refactor(tui): deepen comment compression in the tool result rendering cluster
808abd2f -2 -63 refactor(tui): deepen comment compression in the runner exit lifecycle
899740c8 -11 -446 refactor(subagent): deepen comment compression in the fleet dispatch cluster
77ec5b8f -54 -20 refactor(tui): compress verbose comments in the shell chrome
dd2168bb -1 -250 refactor(tui): compress verbose comments in the provider setup cluster
15b8a262 -7 -186 refactor(exec): compress verbose comments in the exec runner cluster
40035f88 -5 -405 refactor(plugins): compress verbose comments in the plugin loader cluster
30440fd8 -4 -389 refactor(tui): deepen comment compression in the turn state cluster
03e31279 -4 -391 refactor(comments): compress the last 100+ word comment blocks
247271d9 -1 -121 refactor(tui): deepen comment compression in the chrome state
df8339f8 -3 -21 refactor(subagent): deepen comment compression in the run lifecycle
7caa1615 -7 -3 refactor(tui): compress verbose comments in the shell chrome
f0445da0 -10 -206 refactor(session): compress verbose comments in the runtime assembly cluster
c226a277 -11 -499 refactor(tui): compress verbose comments in the agent progress lanes
b79c586f -33 -1118 refactor(tui): compress verbose comments in the geometry zone registry
53c2e116 -2 -95 refactor(src): compress verbose comments in the gateway error module
1f5cd0f6 -3 0 refactor(tui): compress verbose comments in the product host
a906b082 -4 -30 refactor(tui): compress verbose comments in the shell palette
0c13d7fa -4 -257 refactor(tui): compress verbose comments in the shell internals
738194fe 3 -261 refactor(subagent): compress verbose comments in the session store
e6200b12 -2 -49 refactor(tui): compress verbose comments in the diff module
08ffec09 -46 -430 refactor(tui): compress verbose comments in the landing cluster
de64391f -5 0 refactor(tui): compress verbose comments in the shell prompt
0b5831ef -3 -46 refactor(tui): compress verbose comments in the command surfaces
b0fdf162 -9 -656 refactor(config): compress verbose comments in the config cluster
84d4c403 -6 -207 refactor(tui): compress verbose comments in the transcript
617f5232 -6 -250 refactor(tui): compress verbose comments in the overlay host and view
2c4b8a75 -46 -1394 refactor(tui): compress verbose comments in the tool result cluster
25c50b0a -10 0 refactor(tui): compress verbose comments in the wave6 test
1fb43dd3 -7 -97 refactor(permission): compress verbose comments in the worker grant cluster
4e3824f5 -10 -367 refactor(tui): compress verbose comments in the gate and stream event mappers
df001781 -5 -273 refactor(perf): compress verbose comments in the attribution report
dd078b8f -7 -209 refactor(tui): compress verbose comments in the history hydrate module
842449bb -10 -658 refactor(agent): compress verbose comments in the tool aliases module
7709d817 -3 -190 refactor(tui): compress verbose comments in the pending column
239ce96b -4 -378 refactor(e2e): compress verbose comments in the scenario harness
0260380d -5 -515 refactor(tui): compress verbose comments in the stall watchdog
9d7ade17 -3 -138 refactor(plugins): compress verbose comments in the read file guard
8b5c3e70 -4 -291 refactor(tui): compress verbose comments in the tool execution watchdog
f0d48cbf -6 -465 refactor(tui): compress verbose comments in the stream row model
1b51ac1f -2 -68 refactor(tui): compress verbose comments in the tool args module
8cfdbbf6 -9 -350 refactor(tui): compress verbose comments in the ramp module
baae3980 -6 -368 refactor(tui): deepen comment compression in the mark animation module
bd9310ae -1 -273 refactor(tui): deepen comment compression in the theme module
61e2dd70 -1 -159 refactor(tui): compress verbose comments in the long-log retention module
73ab0e9f -4 -288 refactor(agent): compress verbose comments in the tool classification module
f991473f -3 -114 refactor(perf): compress verbose comments in the otel config module
cc953a8a -4 -369 refactor(tui): compress verbose comments in the prompt kill ring module
86bd66ef -4 -295 refactor(agent): compress verbose comments in the tool schema normalize module
41ad6dfe -4 -72 refactor(tui): deepen comment compression in the shell chrome
3aafd272 0 -281 refactor(provider): compress verbose comments in the reasoning effort module
be00bdf9 -11 -766 refactor(tui): compress verbose comments in the thinking reveal module
0adcd750 -6 -205 refactor(plugins): compress verbose comments in the diagnostics module
a0a4223f -4 -297 refactor(tui): compress verbose comments in the allow-once reprompt test
57a90d8b -6 -287 refactor(tui): deepen comment compression in the agent progress module
6c295abb -6 -277 refactor(tui): deepen comment compression in the shell layout module
f54d3224 -22 -266 refactor(agent): deepen comment compression in the toolset cluster
267948dd -6 -270 refactor(session): deepen comment compression in the runtime assembly cluster
156738da -5 -169 refactor(session): deepen comment compression in the session compactor

@TheGreatAxios TheGreatAxios reopened this Oct 10, 2026
@TheGreatAxios TheGreatAxios changed the title Improve code comments refactor(comments): trim verbose comments across the codebase Oct 11, 2026
Comment-only pass over src/subagent (source and co-located tests), the most
comment-dense module left in src (1,402 comment lines). Removed 142 CL-XXXX
mentions from comments and condensed verbose blocks to their rationale.
No code, test, or build changes.
Gustav-Simonsson and others added 28 commits October 10, 2026 18:51
@TheGreatAxios
TheGreatAxios merged commit 563edae into corbitsdev:main Oct 11, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants