Skip to content

chore: comment sweep (why-only comments)#7

Merged
Jepson2k merged 4 commits into
mainfrom
chore/comment-sweep
Jul 8, 2026
Merged

chore: comment sweep (why-only comments)#7
Jepson2k merged 4 commits into
mainfrom
chore/comment-sweep

Conversation

@Jepson2k

Copy link
Copy Markdown
Owner

8 files. Note: also shows one unpushed panel-fix commit (the sweep is the top commit).

Codebase comment sweep — removes comments/docstrings that merely restate the code, keeping short why comments. Per the new CLAUDE.md rule.

Safety (objectively verified, not agent self-report): every changed .py was parsed and compared to its base with docstrings normalized — code ASTs are identical, zero logic change — and all files compile. C++ changes are comment-only.

Draft for review.

🤖 Generated with Claude Code

Jepson2k and others added 3 commits June 22, 2026 11:07
… namespace

- ToolSpec canonicalizes its key to strip().upper() so a plugin tool with a
  lowercase key is still selectable (server uppercases on select) [S2-8]
- rename the abstract Robot._native_tools -> native_tools: it's a required
  public extension point, so the leading underscore was misleading (consumers
  read .tools; backends implement native_tools) [native_tools rename]
- document SceneHandle.overlay group_id as a global namespace (prefix with
  Panel.id) that no-ops when the scene is absent/disconnected [S2-5/S2-11]

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Remove comments/docstrings that merely restate the code; keep short why
comments. Per the new CLAUDE.md rule. Comments and docstrings only — no
logic change (AST-verified against base).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The stale sweep base (13 behind) had uncapped numpy; parol6's branch-matching
CI force-reinstalls this branch, so the uncap pulled numpy 2.5 and broke numba
in parol6 #21. Brings the cap + current API.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Jepson2k
Jepson2k marked this pull request as ready for review July 8, 2026 06:21
# Conflicts:
#	src/waldoctl/client.py
#	src/waldoctl/dry_run_state.py
#	src/waldoctl/robot_status.py
@Jepson2k
Jepson2k merged commit 8580e1d into main Jul 8, 2026
2 checks passed
@Jepson2k
Jepson2k deleted the chore/comment-sweep branch July 14, 2026 17:46
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.

1 participant