chore(deps): bump eclipse-temurin from 21-jre-alpine to 25-jre-alpine

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2

.gitattributes

@@ -0,0 +1,17 @@
+*.java text eol=lf
+*.xml text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.md text eol=lf
+*.html text eol=lf
+*.css text eol=lf
+*.fxml text eol=lf
+*.json text eol=lf
+*.properties text eol=lf
+*.sh text eol=lf
+*.ps1 text eol=crlf
+*.bat text eol=crlf
+*.png binary
+*.jar binary
+*.ico binary
+*.class binary

.github/CODEOWNERS

@@ -0,0 +1,15 @@
+* @devhms
+
+# Core Engine
+/src/main/java/com/nightshade/engine/ @devhms
+
+# Poisoning Strategies
+/src/main/java/com/nightshade/strategy/ @devhms
+
+# Utilities & CLI
+/src/main/java/com/nightshade/util/ @devhms
+/src/main/java/com/nightshade/CLI.java @devhms
+
+# Documentation
+/docs/ @devhms
+/README.md @devhms

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+github: [devhms]
+ko_fi: devhms
+open_collective: nightshade-project
+custom: ["https://buymeacoffee.com/devhms"]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Report a problem or regression with Nightshade
+title: "[Bug]: "
+labels: ["bug", "triage"]
+assignees: []
+---
+
+## Summary
+<!-- A clear and concise description of what the bug is. -->
+
+## Steps to Reproduce
+1. Run command `...`
+2. With input file `...`
+3. See error `...`
+
+## Expected Behavior
+<!-- A clear and concise description of what you expected to happen. -->
+
+## Actual Behavior
+<!-- What actually happened? (e.g., Stack trace, output log, corrupted output) -->
+
+## Environment
+- **OS:** [e.g., Ubuntu 22.04, Windows 11, macOS Sonoma]
+- **JDK Version:** [e.g., OpenJDK 21.0.2]
+- **Nightshade Version:** [e.g., 3.5.0 — find via `java -jar nightshade.jar --version`]
+- **Maven Version:** [e.g., 3.9.6]
+
+## Logs and Output
+<!-- Please paste any relevant logs here. If they are very long, attach them as a file or use a gist. -->
+```
+// PASTE LOGS HERE
+```
+
+## Additional Context
+<!-- Add any other context about the problem here, such as what language the target code is written in. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/devhms/nightshade/security/advisories/new
+    about: Report security issues privately via GitHub PVR
+  - name: General Discussion
+    url: https://github.com/devhms/nightshade/discussions
+    about: Ask questions, share ideas, and engage with the community

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,35 @@
+---
+name: Feature request
+about: Propose a new feature, strategy, or improvement
+title: "[Feature]: "
+labels: ["enhancement", "triage"]
+assignees: []
+---
+
+## Summary
+<!-- A clear and concise description of the new feature or improvement. -->
+
+## Problem
+<!-- Is your feature request related to a problem? Ex. "I'm always frustrated when [...]" -->
+
+## Proposed Solution
+<!-- A clear and concise description of what you want to happen. -->
+
+## Alternatives Considered
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
+
+## Success Criteria
+<!-- How will we know this feature is complete? -->
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+## Additional Context
+<!-- Add any other context or screenshots about the feature request here. -->
+
+## Area
+<!-- Which part of the project does this affect? Delete lines that don't apply. -->
+- Core Engine
+- Poisoning Strategy
+- CLI
+- Documentation
+- Build / CI

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,15 @@
+---
+name: Question
+about: Ask a question about using Nightshade
+title: "[Question]: "
+labels: ["question"]
+assignees: []
+---
+
+## Question
+<!-- Ask your question here. Please be as detailed as possible. -->
+
+## Context
+<!-- What are you trying to achieve? What is the use case? -->
+
+*Note: For general discussions, consider using [GitHub Discussions](https://github.com/devhms/nightshade/discussions) instead.*

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Summary
+<!-- Provide a brief summary of the changes and the rationale behind them. -->
+
+## Change Type
+<!-- Delete the lines that do not apply: -->
+- `feat`: A new feature or poisoning strategy
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `chore`: Build system, CI, dependencies, or maintenance
+
+## Related Issues
+<!-- Link to issues this PR resolves. Use "Fixes #<issue>" or "Closes #<issue>". -->
+- Closes #
+
+## Checklist
+- [ ] I have read the [CONTRIBUTING](../CONTRIBUTING.md) guide
+- [ ] I have run `mvn verify` locally and all tests pass
+- [ ] I have added or updated tests for my changes
+- [ ] I have updated the documentation accordingly
+- [ ] My commits are signed with `-s` (DCO)
+
+## Breaking Changes
+- [ ] Yes
+- [ ] No
+<!-- If yes, describe the impact and migration path below. -->
+
+## Screenshots / Logs
+<!-- If applicable, add screenshots or output logs to help explain your changes. -->

.github/dependabot.yml

@@ -0,0 +1,48 @@
+version: 2
+updates:
+  - package-ecosystem: "maven"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    target-branch: "main"
+    labels:
+      - "dependencies"
+      - "java"
+    commit-message:
+      prefix: "chore(deps)"
+    ignore:
+      - dependency-name: "org.openjfx:*"
+        update-types: ["version-update:semver-major"]
+    reviewers:
+      - "devhms"
+
+  - package-ecosystem: "docker"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    labels:
+      - "dependencies"
+      - "docker"
+    commit-message:
+      prefix: "chore(deps)"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    target-branch: "main"
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "chore(deps)"
+    reviewers:
+      - "devhms"

.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI - Build and Test
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae1a # v4.2.0
+
+    - name: Set up JDK 21
+      uses: actions/setup-java@99b6cbb1ec2b05a0d87cf5001fcd45d466b493be # v4.2.0
+      with:
+        java-version: '21'
+        distribution: 'temurin'
+        cache: 'maven'
+
+    - name: Build and Test
+      run: ./mvnw clean verify -B --no-transfer-progress
+
+    - name: Upload Test Results
+      if: always()
+      uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.2.0
+      with:
+        name: test-results
+        path: target/surefire-reports/
+        retention-days: 7
+
+    - name: Upload Coverage Report
+      if: always()
+      uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.2.0
+      with:
+        name: jacoco-report
+        path: target/site/jacoco/
+        retention-days: 7

.github/workflows/codeql.yml

@@ -0,0 +1,50 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  schedule:
+    - cron: "27 3 * * 0"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+      packages: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ["java"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@c1e323688fd81a25caa38c78aa6df2d33d3e20d9 # v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@78ed0c7291d93e40c51b085850dc669a4c3ab73b # v3
+        with:
+          languages: ${{ matrix.language }}
+          queries: security-extended
+          build-mode: autobuild
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@78ed0c7291d93e40c51b085850dc669a4c3ab73b # v3
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@78ed0c7291d93e40c51b085850dc669a4c3ab73b # v3
+        with:
+          category: "/language:${{ matrix.language }}"