Skip to content

docs: sweep — mouse stack (#304) + warn-mode overlay (#347)#371

Merged
fentas merged 2 commits into
masterfrom
docs/post-304-347-sweep
May 30, 2026
Merged

docs: sweep — mouse stack (#304) + warn-mode overlay (#347)#371
fentas merged 2 commits into
masterfrom
docs/post-304-347-sweep

Conversation

@fentas
Copy link
Copy Markdown
Owner

@fentas fentas commented May 30, 2026

Summary

Catches the docs up after the 9-PR landing run that closed #304 (mouse-click on file paths + URLs) and #347 (`--ebpf-mode=warn` plus `Alt+Shift+W` scrollback dump).

Files touched

CLAUDE.md

  • File-layout block lists `src/mouse.zig` and the two new module directories (`mouse_links/`, `mouse_urls/`).
  • Module-framework hook list adds `onMouseClick` + `onAction`.
  • Three new "things to be careful about" entries:
    • mouse intercept opt-in + alt-screen gating
    • `mouse_urls` placement BEFORE `guardrail` in the modules tuple (banner keystroke precedence)
    • warn-mode render-and-clear semantics + proxy swallow-on-miss

docs/modules.md

  • Hook list adds `onMouseClick` + `onAction`.
  • New per-module sections for `mouse_links` and `mouse_urls` (config snippets + the ordering rule).
  • One-liner on warn-mode UX cross-referencing operator-workflow.

docs/architecture.md

  • Module-layout tree was missing several modules — now lists `mouse.zig`, both mouse modules, plus `llm/`, `history/`, `security_guard/` (was incomplete pre-sweep).
  • New "Mouse intercept" subsection covering opt-in, DECSET trio, parse-then-dispatch flow, alt-screen gate, per-module ring.

docs/operator-workflow.md

  • New "Warn mode (`--ebpf-mode=warn`)" subsection in section 4 (eBPF setup) covering the systemd override snippet, the `⚠ N` segment, and the `Alt+Shift+W` dump format.

README.md

  • Built-in modules table adds `mouse_links` + `mouse_urls` rows; the `security_guard` row mentions `Alt+Shift+W` and the new `onAction` hook.
  • Test-count bump 949 → 1112.

Test plan

  • `zig build test` — 1112/1112 (no code touched; docs-only)
  • `zig fmt --check` (n/a — docs)
  • Spot-check rendered Markdown for the modules.md table + the new architecture.md fenced block

🤖 Generated with Claude Code

Catches the docs up after the 9-PR landing run that closed #304
(mouse-click on file paths + URLs) and #347 (`--ebpf-mode=warn`
plus Alt+Shift+W scrollback dump).

CLAUDE.md:
- File-layout block lists `src/mouse.zig` and the two new module
  directories (`mouse_links/`, `mouse_urls/`).
- Module-framework hook list adds `onMouseClick` + `onAction`.
- Three new "things to be careful about" entries:
  - mouse intercept opt-in + alt-screen gating
  - mouse_urls placement before guardrail in the modules tuple
  - warn-mode render-and-clear semantics + proxy swallow-on-miss

docs/modules.md:
- Hook list adds onMouseClick + onAction.
- New per-module sections for mouse_links and mouse_urls (config
  snippets + the ordering rule).
- One-liner on warn-mode UX referring to operator-workflow.

docs/architecture.md:
- Module-layout tree adds mouse.zig + the two mouse modules +
  llm/ + history/ + security_guard/ (was incomplete pre-sweep).
- New "Mouse intercept" subsection covering opt-in, DECSET trio,
  parse-then-dispatch flow, alt-screen gate, per-module ring.

docs/operator-workflow.md:
- New "Warn mode (--ebpf-mode=warn)" subsection in section 4
  (eBPF setup) covering the systemd override, the `⚠ N` segment,
  and the Alt+Shift+W dump format.

README.md:
- Built-in modules table adds mouse_links + mouse_urls rows; the
  security_guard row mentions Alt+Shift+W and the new `onAction`
  hook.
- Test-count bump 949 → 1112.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Subagent caught that the trust-mode table implied `.whitelist_only`
would benefit from session-trust on its own. In reality the set is
only ever populated by `.ask_each`'s `[a]llow always` keystroke;
`.whitelist_only` users only see the static `url_whitelist`. Spell
that out so readers don't expect persistence.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@fentas fentas merged commit a9acc91 into master May 30, 2026
4 of 5 checks passed
@fentas fentas deleted the docs/post-304-347-sweep branch May 30, 2026 06:30
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.

feat: clickable mouse events for file paths + URLs (with security-gated URL opening)

2 participants