Metadata-Version: 2.4
Name: codesentinel
Version: 1.0.3
Summary: Automated Maintenance & Security Monitoring | A Polymath Project
Home-page: https://github.com/joediggidyyy/CodeSentinel
Author: joediggidyyy
Author-email: joediggidyyy <joediggidy3@gmail.com>
Maintainer-email: joediggidyyy <joediggidy3@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/joediggidyyy/CodeSentinel
Project-URL: Documentation, https://codesentinel.readthedocs.io/
Project-URL: Repository, https://github.com/joediggidyyy/CodeSentinel
Project-URL: Issues, https://github.com/joediggidyyy/CodeSentinel/issues
Project-URL: Changelog, https://github.com/joediggidyyy/CodeSentinel/blob/main/CHANGELOG.md
Keywords: security,monitoring,maintenance,automation,alerts
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: schedule>=1.1.0
Requires-Dist: psutil>=5.8.0
Requires-Dist: pathlib2>=2.3.0; python_version < "3.4"
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: flake8>=3.8.0; extra == "dev"
Requires-Dist: black>=21.0.0; extra == "dev"
Requires-Dist: mypy>=0.800; extra == "dev"
Requires-Dist: sphinx>=4.0.0; extra == "dev"
Provides-Extra: gui
Provides-Extra: full
Requires-Dist: requests>=2.25.0; extra == "full"
Requires-Dist: schedule>=1.1.0; extra == "full"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# CodeSentinel

*A Polymath Project*

CodeSentinel is a cross-platform application that integrates with VS Code or any major IDE to provide a secure, automated, self-healing development environment.

## Project Structure

```
CodeSentinel/
├── README.md                          (main documentation)
├── CHANGELOG.md                       (release notes)
├── QUICK_START.md                     (user installation guide)
├── PUBLISH_NOW.md                     (v1.0.3.beta: PyPI publication steps)
├── setup.py, pyproject.toml           (packaging configuration)
├── requirements.txt                   (dependencies)
├── SECURITY.md, CONTRIBUTING.md       (project guidelines)
├── INSTALL_CODESENTINEL_GUI.py        (cross-platform installer)
│
├── codesentinel/                      (package source)
│   ├── __init__.py                    (version: 1.0.3.beta)
│   ├── cli/                           (command-line interface)
│   ├── core/                          (core functionality & auditing)
│   ├── gui/                           (GUI components)
│   └── utils/                         (utilities: config, alerts, scheduler, file integrity)
│
├── tests/                             (test suite: 22/22 passing)
│
├── dist/                              (distributions: sdist + wheel)
│
├── docs/                              (documentation & reference)
│   ├── V1_0_3_DISTRIBUTION_REPORT.md (technical overview with scheduling & customization)
│   ├── V1_0_3_BETA_TEST_REPORT.md    (all test results)
│   ├── PYPI_PUBLICATION_GUIDE.md     (detailed PyPI guide)
│   └── [20+ reference files]
│
└── .github/                           (GitHub configuration & CI/CD)
```

## Core Features

- **Security-First Architecture**: Automated vulnerability scanning and security monitoring
- **Multi-Channel Alerts**: Console, file logging, email, and Slack integration
- **GitHub Integration**: Seamless GitHub and Copilot AI support
- **IDE Integration**: Support for VS Code, PyCharm, IntelliJ, Visual Studio, and more
- **Intelligent Audit**: Development audit with `!!!!` command for automated remediation
- **Process Monitoring**: Low-cost daemon prevents orphaned processes and resource leaks
- **Maintenance Automation**: Scheduled tasks for daily, weekly, and monthly operations

### Process Monitoring

Built-in background daemon that automatically:

- Tracks CodeSentinel-spawned processes
- Detects and terminates orphaned processes
- Cleans up zombie/defunct processes
- Minimal resource usage (<0.1% CPU, ~1-2MB memory)

Active whenever CodeSentinel is running to prevent resource leaks. See `docs/PROCESS_MONITOR.md` for details.

## Installation

```bash
pip install codesentinel
```

## Quick Start

```bash
# Run setup wizard
codesentinel-setup

# Check status
codesentinel status

# Run development audit
codesentinel !!!!
```

## Documentation

- [Installation Guide](INSTALLATION.md)
- [Security Policy](SECURITY.md)
- [Contributing Guidelines](CONTRIBUTING.md)
- [Process Monitor](docs/PROCESS_MONITOR.md)
- [Changelog](CHANGELOG.md)

## Principles

**SECURITY > EFFICIENCY > MINIMALISM**

CodeSentinel follows a security-first approach with emphasis on efficiency and minimal overhead.
