Skip to content

docs: remove stale ⌃C-family hotkey assertions from comments (closes #1925)#1958

Open
john-the-dev wants to merge 1 commit into
sonichi:mainfrom
john-the-dev:fix/stale-hotkey-comments
Open

docs: remove stale ⌃C-family hotkey assertions from comments (closes #1925)#1958
john-the-dev wants to merge 1 commit into
sonichi:mainfrom
john-the-dev:fix/stale-hotkey-comments

Conversation

@john-the-dev

Copy link
Copy Markdown
Contributor

Summary

Sweeps the comment/doc references to old ⌃C/⌃V/⌃M hotkeys that were retired when the Electron Sutando.app switched to a configurable contract published in state/hotkeys.json (#1920/#1924).

No behavior change — comments and docs only.

Files changed:

  • src/Sutando/main.swift:13 — old "Defaults: drop_context=⌃C..." list → pointer to hotkeys.json
  • skills/context-drop/SKILL.md — "Sutando.app's ⌃C hotkey" → "action (hotkey configurable via state/hotkeys.json)"
  • skills/context-drop/Sources/ax-read/main.swift — two comment references to "⌃C drops"
  • src/startup.sh — five occurrences: section comment, install message, inline comment, startup echo

Left alone:

  • src/health-check.py:1358 — PR fix(health-check): derive sutando-app hotkey detail from published state/hotkeys.json #1924 (open) already targets that exact line; touching it here would create a merge conflict.
  • src/web-client.ts:836 — references ⌃V/⌃M in the web client event loop, which still registers those hotkeys on the browser side; accurate.
  • src/Sutando/main.swift:1118-1119 — code comment documenting why ⌃C/⌃R are avoided in favor of ⌃⇧C/⌃⇧R; these are load-bearing design notes, not stale assertions.

Closes #1925.

Test plan

  • grep -rn '⌃C\|⌃V\|⌃M' src/ skills/context-drop/ — only the intentional code-level references remain (web-client.ts event loop, main.swift avoid-⌃C rationale, main.swift recording toggle)
  • Startup log shows "✓ Sutando (hotkeys via state/hotkeys.json)" instead of the old "(⌃C/⌃V/⌃M)"
  • No functional change — context-drop, startup, health-check all work as before

🤖 Generated with Claude Code

https://claude.ai/code/session_01QB3qZQrwponfum2JFNvHeh

…onichi#1925)

The ⌃C/⌃V/⌃M defaults were retired when the Electron Sutando.app switched
to a configurable hotkey contract published in state/hotkeys.json (sonichi#1920/sonichi#1924).
Several comments/docs still asserted the old ⌃C binding, misleading operators
debugging hotkey issues (issue sonichi#1925: "spent a session chasing dead ⌃C
bindings").

Changes (comments/docs only — no behavior change):
- src/Sutando/main.swift:13 — replace stale defaults list with pointer to hotkeys.json
- skills/context-drop/SKILL.md — "⌃C hotkey" → "configurable via state/hotkeys.json"
- skills/context-drop/Sources/ax-read/main.swift — same in two code comments
- src/startup.sh — five occurrences: section header, install messages, and startup echo

Leaves health-check.py:1358 untouched (PR sonichi#1924 already targets that line).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QB3qZQrwponfum2JFNvHeh
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Coverage Gate

No Python changes — nothing to gate (bar: 95% on changed lines).

@qingyun-wu qingyun-wu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving — comment/doc sweep matching the #1920 hotkeys.json contract; no behavior surface, CI green.

@john-the-dev john-the-dev marked this pull request as ready for review July 8, 2026 14:38
@qingyun-wu

Copy link
Copy Markdown
Collaborator

Automated review:

  • This comment cleanup swaps in a new incorrect path: skills/context-drop/SKILL.md:3 and skills/context-drop/Sources/ax-read/main.swift:3 now say the hotkey is configurable via state/hotkeys.json, but the app still reads the live config from ~/.config/sutando/hotkeys.json (src/Sutando/main.swift:1129-1151) and only publishes the resolved bindings to state/hotkeys.json (src/Sutando/main.swift:1177-1196). As written, these comments tell operators to edit a generated status file that the app never reads.

@qingyun-wu

Copy link
Copy Markdown
Collaborator

Automated mergeability review (2026-07-09)

Signal: NOT MERGEABLE

Current blocker(s):

  • Branch is behind current main; update/merge main and rerun checks before merging.

This is a conservative backlog triage signal. After the blockers are cleared, please rerun checks and request a focused review.

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.

docs/comments: stale ⌃C-family hotkey mentions contradict the published hotkeys.json contract (#1920/#1924 follow-up)

2 participants