Develop

.commitlintrc.json

@@ -0,0 +1,24 @@
+{
+  "extends": ["@commitlint/config-conventional"],
+  "rules": {
+    "type-enum": [
+      2,
+      "always",
+      [
+        "feat",
+        "fix",
+        "docs",
+        "style",
+        "refactor",
+        "perf",
+        "test",
+        "build",
+        "ci",
+        "chore",
+        "revert"
+      ]
+    ],
+    "subject-case": [0],
+    "header-max-length": [2, "always", 100]
+  }
+}

.coveragerc

@@ -0,0 +1,92 @@
+# Coverage.py configuration file
+# https://coverage.readthedocs.io/
+
+[run]
+# Measure branch coverage in addition to statement coverage
+branch = True
+
+# Source directories to measure
+source = plotsense
+
+# Files to omit from coverage
+omit =
+    */tests/*
+    */test_*.py
+    */__pycache__/*
+    */venv/*
+    */env/*
+    */.venv/*
+    setup.py
+    */site-packages/*
+
+# Parallel mode for running tests in parallel
+parallel = False
+
+[report]
+# Precision for coverage percentage
+precision = 2
+
+# Show lines that weren't executed
+show_missing = True
+
+# Don't skip covered files in the report
+skip_covered = False
+
+# Skip files with no statements
+skip_empty = True
+
+# Sort report by coverage percentage
+sort = Cover
+
+# Fail if coverage is below this percentage (can be overridden in CI)
+# fail_under = 80
+
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    # Have to re-enable the standard pragma
+    pragma: no cover
+
+    # Don't complain about missing debug-only code:
+    def __repr__
+    def __str__
+
+    # Don't complain if tests don't hit defensive assertion code:
+    raise AssertionError
+    raise NotImplementedError
+    raise ValueError
+
+    # Don't complain if non-runnable code isn't run:
+    if __name__ == .__main__.:
+    if 0:
+    if False:
+
+    # Type checking only code
+    if TYPE_CHECKING:
+    if typing.TYPE_CHECKING:
+
+    # Abstract methods
+    @abstractmethod
+    @abc.abstractmethod
+
+    # Overloaded functions
+    @overload
+
+    # Protocol methods
+    @protocol
+    \.\.\.
+
+[html]
+# Directory for HTML report
+directory = htmlcov
+
+# Title for HTML report
+title = PlotSense Test Coverage Report
+
+[xml]
+# Output file for XML report (for CI/CD tools)
+output = coverage.xml
+
+[json]
+# Output file for JSON report
+output = coverage.json
+show_contexts = True

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,85 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+<!-- A clear and concise description of what the bug is -->
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1.
+2.
+3.
+4.
+
+**Minimal Reproducible Example:**
+
+```python
+# Paste your code here
+import plotsense as ps
+import pandas as pd
+
+# Your code that reproduces the issue
+```
+
+## Expected Behavior
+
+<!-- A clear and concise description of what you expected to happen -->
+
+## Actual Behavior
+
+<!-- What actually happened -->
+
+## Error Messages
+
+```
+# Paste the full error traceback here
+```
+
+## Environment
+
+**System Information:**
+- OS: <!-- e.g., Windows 11, Ubuntu 22.04, macOS 14 -->
+- Python Version: <!-- e.g., 3.11.5 -->
+- PlotSense Version: <!-- e.g., 0.1.3 -->
+
+**Dependencies:**
+```bash
+# Paste output of: pip list | grep -E "plotsense|pandas|matplotlib|groq"
+```
+
+## Screenshots
+
+<!-- If applicable, add screenshots to help explain your problem -->
+
+## Additional Context
+
+<!-- Add any other context about the problem here -->
+
+**Data Sample (if applicable):**
+
+```python
+# If the bug is data-related, provide a small sample DataFrame
+df = pd.DataFrame({
+    # Your data
+})
+```
+
+## Workaround
+
+<!-- If you found a temporary workaround, describe it here -->
+
+## Checklist
+
+- [ ] I have searched existing issues to ensure this bug hasn't been reported
+- [ ] I have tested with the latest version of PlotSense
+- [ ] I have provided a minimal reproducible example
+- [ ] I have included the full error traceback
+- [ ] I have checked that my GROQ_API_KEY is valid (if applicable)

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,83 @@
+---
+name: Feature Request
+about: Suggest an idea for PlotSense
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+
+<!-- A clear and concise description of the feature you'd like -->
+
+## Problem Statement
+
+<!-- Is your feature request related to a problem? Please describe. -->
+<!-- Example: "I'm always frustrated when..." -->
+
+## Proposed Solution
+
+<!-- Describe the solution you'd like -->
+
+**Example Usage:**
+
+```python
+# How you envision using this feature
+import plotsense as ps
+
+# Your proposed API/usage
+```
+
+## Alternatives Considered
+
+<!-- Describe any alternative solutions or features you've considered -->
+
+## Benefits
+
+<!-- Why would this feature be useful? Who would benefit from it? -->
+
+- **For Data Scientists:**
+- **For Analysts:**
+- **For the Project:**
+
+## Implementation Ideas
+
+<!-- If you have ideas about how this could be implemented, share them here -->
+
+**Affected Components:**
+- [ ] Recommendation Engine
+- [ ] Plot Generator
+- [ ] Explanation System
+- [ ] Web Interface
+- [ ] Documentation
+- [ ] Tests
+- [ ] Other: <!-- specify -->
+
+**Potential Challenges:**
+
+## Mockups/Examples
+
+<!-- If applicable, add mockups, diagrams, or examples from other tools -->
+
+## Additional Context
+
+<!-- Add any other context or screenshots about the feature request here -->
+
+## Would you like to work on this?
+
+- [ ] Yes, I'd like to contribute this feature
+- [ ] No, but I'm happy to help test it
+- [ ] Just suggesting the idea
+
+## Related Features/Issues
+
+<!-- Link to related issues or features -->
+
+Related to #
+
+## Checklist
+
+- [ ] I have searched existing issues/PRs for similar feature requests
+- [ ] I have provided a clear use case for this feature
+- [ ] I have considered how this fits with PlotSense's mission
+- [ ] I have provided example usage code.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,45 @@
+---
+name: Question
+about: Ask a question about using PlotSense
+title: '[QUESTION] '
+labels: question
+assignees: ''
+---
+
+## Question
+
+<!-- Ask your question here -->
+
+## Context
+
+<!-- Provide context about what you're trying to accomplish -->
+
+**What I'm trying to do:**
+
+**What I've tried:**
+
+```python
+# Your code attempts
+```
+
+## Environment
+
+- PlotSense Version: <!-- e.g., 0.1.3 -->
+- Python Version: <!-- e.g., 3.11 -->
+
+## Expected Outcome
+
+<!-- What result are you hoping to achieve? -->
+
+## Resources Checked
+
+<!-- Have you checked these resources? -->
+
+- [ ] README.md
+- [ ] TESTING.md
+- [ ] [Documentation/Examples](<!-- link if available -->)
+- [ ] Existing issues
+
+## Additional Information
+
+<!-- Any other details that might help answer your question -->

.github/pull_request_template.md

@@ -0,0 +1,61 @@
+# Pull Request
+
+## Description
+
+<!-- Provide a brief description of the changes in this PR -->
+
+### Type of Change
+
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Test additions/improvements
+- [ ] CI/CD changes
+- [ ] Dependencies update
+
+## Related Issues
+
+<!-- Link to related issues using #issue_number -->
+
+Closes #
+Related to #
+
+## Changes Made
+
+<!-- Provide a detailed list of changes -->
+
+-
+-
+-
+
+## Documentation
+
+- [ ] I have updated the README.md (if needed)
+- [ ] I have updated TESTING.md (if test-related changes)
+- [ ] I have added/updated docstrings for new functions/classes
+- [ ] I have updated type hints/annotations
+- [ ] I have added comments for complex logic
+
+
+## Checklist
+
+<!-- Final checklist before submitting -->
+
+- [ ] I have read the [CONTRIBUTING](../CONTRIBUTING.md) guidelines
+- [ ] My branch is up to date with the target branch
+- [ ] I have resolved all merge conflicts
+- [ ] All CI/CD checks pass
+- [ ] Code has been reviewed by me
+- [ ] I have tested this on my local environment
+- [ ] Documentation is updated
+- [ ] Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)
+
+<!--
+Thank you for contributing to PlotSense! 🎉
+Please ensure all checklist items are completed before requesting a review.
+-->