Security Logging Copilot Plugin

Welcome to the Security Logging Copilot Plugin repository. This plugin is designed to assist developers in writing secure, compliant, and structured logging statements directly within their development environments.

Overview

Modern software development requires strict adherence to security and compliance standards (such as OWASP, GDPR, HIPAA, and PCI-DSS). This plugin provides real-time linting, suggestions, and auto-completion for security logging, ensuring sensitive data is never leaked and required audit contexts are always captured.

Features

• Sensitive Data Detection: Identifies potential PII, credentials, and secrets in logging statements.
• Log Context Validation: Checks if logging statements contain necessary metadata (actor, action, outcome, timestamps).
• CRLF Injection Prevention: Lints for unsafe input concatenation in log messages.
• Structured Log Formatting: Promotes JSON or structured logging patterns.

Getting Started

Prerequisites

• Python 3 (v3.8 or higher recommended)
• Node.js (v18 or higher recommended)
• Git

Installation

1. Clone the repository:

   git clone https://github.com/your-organization/security-logging-copilot-plugin.git
   cd security-logging-copilot-plugin

2. Install dependencies:

   python3 -m venv .venv
   source .venv/bin/activate
   pip3 install -r requirements.txt

Running Tests

To execute the BDD feature specs, run:

source .venv/bin/activate
pytest tests/step_defs/

Spec-Driven Development (SDD)

This repository follows a strict Spec-Driven Development workflow driven by spec-kit and the Kaggle production-grade BDD guidelines to guide development:

• Constitution: Project rules, security policies, and standards are defined in .specify/memory/constitution.md.
• Project Context: The system layout and technologies are documented in .specify/project-context.md.
• Feature Specs: High-level requirements are modeled as specifications inside specs/security-logging-plugin.spec.md.
• Gherkin Features: Specific, executable scenarios (Given/When/Then) are defined as BDD feature files under specs/features/.

Development and IDE Environment

This repository is optimized for development with the Antigravity IDE and Antigravity 2.0 ecosystem.

• Workspace Guidelines: Project-specific rules and agent instructions are defined in .agents/AGENTS.md.
• Model Context Protocol (MCP): Any custom MCP tools or hooks will be configured in the .agents/ folder.
• Model Selection & Routing: Task-based model recommendations for Gemini, Claude, and GPT families, along with runtime environment detection logic, are detailed in security-logging-advisor/docs/model-routing.md.

Authors

• Justin Soderberg - sodejm

License

This project is licensed under the PolyForm Noncommercial License 1.0.0 - see the LICENSE file for details.