Skip to content

Remove dead stub files from src/silentguard/ #37

Description

@TheZupZup

Overview

Several files in src/silentguard/ exist but contain no working code. They are not imported anywhere in the application and can mislead contributors trying to understand the codebase.

Note: blocked_view.py is no longer listed here. It was converted into a short documentation shim after the TUI Rules view was implemented in #40.

File Content Problem
rules.py Only comments and TODOs All rules logic currently lives in monitor.py
actions.py Placeholder functions / dead action planning Real block/unblock helpers live in monitor.py; TUI actions live in tui.py
ui.py Empty or unused UI placeholder Both UIs are implemented in main.py and tui.py

Additionally, pyproject.toml.save is an outdated backup file that serves no purpose in the repo.

What needs to be done

  • Verify none of these files are imported anywhere: grep -r "rules\|actions\|from silentguard.ui" src/
  • Delete src/silentguard/rules.py
  • Delete src/silentguard/actions.py
  • Delete src/silentguard/ui.py
  • Delete pyproject.toml.save
  • Run the app and tests after deletion to confirm nothing broke

Goal

The src/silentguard/ directory contains only files with real working code or intentional documentation shims. A new contributor reading the source should immediately understand what each file does.

Notes

If any of these files are needed for future features, they should be created fresh when that feature is started — not kept as empty placeholders that confuse the module structure.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions