Refactor and revise of entire codebase

.github/CODEOWNERS

@@ -0,0 +1,8 @@
+---
+# CODEOWNERS file for scratchpad_fayeblade repository
+# These owners will be the default owners for everything in the repo.
+# Unless a later match takes precedence, these users will be requested for
+# review when someone opens a pull request.
+
+# Default owners for all files in the repository
+* @Fayeblade1488 @para-droid-ai

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,33 @@
+---
+name: Bug Report
+description: File a bug report
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Also tell us, what did you expect to happen?
+      placeholder: Tell us what you see!
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Reproduction steps
+      description: "How can we reproduce this bug? Please provide a minimal reproducible example."
+      placeholder: "1. Go to '...'\n2. Click on '...'\n3. Scroll down to '...'\n4. See error"
+    validations:
+      required: true
+  - type: dropdown
+    id: version
+    attributes:
+      label: Version
+      description: What version of our software are you running?
+      options:
+        - 1.0.0 (Latest)
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+description: Suggest an idea for this project
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+  - type: textarea
+    id: description
+    attributes:
+      label: What would you like to see?
+      description: A clear and concise description of what the problem is.
+      placeholder: "I'm always frustrated when..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: What is the solution you'd like to see?
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true

.github/SECURITY.md

@@ -0,0 +1,41 @@
+# Security Policy
+
+## Supported Versions
+
+We actively support security updates for the following versions:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | :white_check_mark: |
+| < 1.0   | :x:                |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this project, please report it responsibly. We appreciate your help in keeping our users safe.
+
+### How to Report
+
+-  **Do not** create public GitHub issues for security vulnerabilities.
+-  Email us at [Faye](mailto:[email protected]) with details about the vulnerability.
+-  Include:
+  - A description of the vulnerability
+  - Steps to reproduce
+  - Potential impact
+  - Any suggested fixes (optional)
+
+### Our Commitment
+
+-  We will acknowledge receipt of your report within 48 hours.
+-  We will provide regular updates on our progress (at least every 7 days) until the issue is resolved.
+-  We will credit you (if desired) once the vulnerability is fixed and publicly disclosed.
+-  We follow a 90-day disclosure timeline from the initial report.
+
+### Disclosure Policy
+
+-  Once fixed, we will publish a security advisory on GitHub.
+-  We will not disclose vulnerability details until a fix is available.
+-  We encourage coordinated disclosure with the security community.
+
+## Contact
+
+For questions about this policy, email [Faye](mailto:[email protected]).

.github/workflows/ci.yml

@@ -0,0 +1,116 @@
+---
+name: "CI"
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint_and_security:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12 (tools)
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install tooling
+        run: |
+          python -m pip install --upgrade pip
+          if [ -f requirements-dev.txt ]; then
+            pip install -r requirements-dev.txt
+          elif [ -f requirements.txt ]; then
+            pip install -r requirements.txt
+          else
+            pip install ruff yamllint pip-audit
+          fi
+
+      - name: Ruff lint
+        run: ruff check .
+
+      - name: YAML lint
+        run: |
+          yamllint .
+
+      - name: pip-audit (vuln scan)
+        run: |
+          if [ -f requirements-dev.txt ]; then
+            pip-audit -r requirements-dev.txt || true
+          elif [ -f requirements.txt ]; then
+            pip-audit -r requirements.txt || true
+          else
+            pip-audit || true
+          fi
+        # Keep CI green for now; flip to hard fail later by removing `|| true`
+
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: [lint_and_security]
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    env:
+      PYTHONUNBUFFERED: "1"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install deps (tests + quality)
+        run: |
+          python -m pip install --upgrade pip
+          if [ -f requirements-dev.txt ]; then
+            pip install -r requirements-dev.txt
+          elif [ -f requirements.txt ]; then
+            pip install -r requirements.txt
+          else
+            pip install pytest pyyaml coverage pytest-cov
+          fi
+
+      - name: Run tests with coverage (JUnit + threshold)
+        run: |
+          pytest -v \
+            --junitxml=pytest-junit.xml \
+            --cov=. --cov-report=xml:coverage.xml --cov-report=term-missing \
+            --cov-fail-under=65
+
+      - name: Upload coverage.xml
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-${{ matrix.python-version }}
+          path: coverage.xml
+          if-no-files-found: error
+          retention-days: 7
+
+      - name: Upload JUnit report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: junit-${{ matrix.python-version }}
+          path: pytest-junit.xml
+          if-no-files-found: error
+          retention-days: 7

.gitignore

@@ -0,0 +1,39 @@
+# Rust
+/target/
+**/*.rs.bk
+Cargo.lock
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.env
+venv/
+.envrc
+
+# OS Junk
+.DS_Store
+Thumbs.db
+ehthumbs.db
+desktop.ini
+Icon?
+
+# Editor Trash
+*.swp
+*.swo
+*.bak
+*.tmp
+*.log
+.idea/
+.vscode/
+
+# Test/Build Artifacts
+/tests/results/
+*.test.*
+*.out
+*.coverage
+*.prof
+
+# Misc
+node_modules/

.yamllint.yaml

@@ -0,0 +1,33 @@
+---
+# .yamllint: YAML linting configuration for Scratchpad Framework
+extends: default
+
+rules:
+  braces: disable
+  brackets: disable
+  colons:
+    max-spaces-after: 1
+    level: error
+  comments:
+    require-starting-space: true
+    min-spaces-from-content: 1
+  document-start:
+    present: true
+    level: warning  # Warn instead of error for missing ---
+  document-end: disable
+  empty-lines:
+    max: 5  # Allow more blank lines in framework content
+    max-start: 0
+    max-end: 1
+  hyphens:
+    max-spaces-after: 1
+  indentation:
+    spaces: 2
+    indent-sequences: consistent
+  line-length: disable  # AI framework content needs arbitrary line lengths
+  new-lines:
+    type: unix
+  trailing-spaces:
+    level: warning  # Warn instead of error for trailing spaces
+  truthy:
+    level: warning  # Warn instead of error for truthy values

.yamllintignore

@@ -0,0 +1,30 @@
+# Python virtual environments
+venv/
+.venv/
+env/
+.env/
+
+# Node.js
+node_modules/
+
+# Build and cache directories
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+
+# Git
+.git/
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db