Auto repair tool

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,100 @@
+name: Bug Report
+description: Found a bug? Report it here!
+title: "[BUG] "
+labels: ["bug"]
+assignees:
+  - Patricklumowa
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to fill out this template!
+        **The more information you provide, the easier it will be to identify and fix the bug.**
+        If you want a guide on filing bug reports effectively, you can [find it here](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html).
+  - type: checkboxes
+    id: checked-bugs
+    attributes:
+      label: Have you checked to see if this issue has already been reported?
+      options:
+        - label: This bug has not been previously reported.
+    validations:
+      required: true
+  - type: textarea
+    id: describe-bug
+    attributes:
+      label: Describe The Bug
+      description: "Explain what goes wrong when using the bot."
+      placeholder: "E.g. The bot places pixels on the wrong coordinates or skips areas."
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: "Describe what you expected to happen or why you think the current behavior is wrong."
+      placeholder: |
+        E.g. The bot should place pixels exactly according to the template image.
+        E.g. The bot should respect rate limits and avoid bans.
+    validations:
+      required: false
+  - type: textarea
+    id: things-tried
+    attributes:
+      label: Things You Tried
+      description: "List all attempts you made to fix or work around the bug."
+      placeholder: "E.g. Restarted the bot, tried a different template, or updated the pixel map."
+    validations:
+      required: false
+  - type: textarea
+    id: reproduce-bug
+    attributes:
+      label: Reproduce The Bug
+      description: "Explain exactly how to trigger the bug."
+      placeholder: |
+        E.g.
+        1. Launch the bot
+        2. Load a template image
+        3. Start pixel placement
+        4. Observe that some pixels are placed incorrectly or skipped
+    validations:
+      required: false
+  - type: textarea
+    id: error-message
+    attributes:
+      label: Error Message
+      description: "If there are error messages, add them here."
+      placeholder: "E.g. Error: Coordinates out of range!"
+    validations:
+      required: false
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: "Include screenshots or links to illustrate the problem."
+      placeholder: "E.g. Imgur link showing the pixel placement error"
+    validations:
+      required: false
+  - type: textarea
+    id: system-information
+    attributes:
+      label: System Information
+      description: "Provide details about your OS, bot version, and browser. Please fill this out!"
+      placeholder: |
+        OS: (E.g. Windows)
+        wplace-autoBOT Version: 2.0
+        Browser: Mozilla 142.0
+        You found an easter egg :3
+      value: |
+        OS: 
+        wplace-autoBOT Version: 
+        Browser:
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information
+      description: "Add any other context about the problem here."
+      placeholder: "E.g. This issue started after the last update or happens only with large templates."
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Community Support & Questions (Discord)
+    url: https://discord.gg/knkNRYyQcm
+    about: Join the Discord if you have questions or want to discuss AutoBOT with the community.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,48 @@
+name: Feature Request
+description: Have an idea you want added? Suggest it here!
+title: "[FEAT] "
+labels: ["enhancement"]
+assignees:
+  - Patricklumowa
+body:
+  - type: textarea
+    id: related-problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: "Describe what the problem is."
+      placeholder: |
+        E.g. It's tedious to manually place pixels to recreate complex designs.
+        E.g. The bot currently can't detect areas that need fixing automatically.
+    validations:
+      required: false
+  - type: textarea
+    id: feature-solution
+    attributes:
+      label: Describe the solution you'd like
+      description: "Describe what you want to happen."
+      placeholder: |
+        E.g. Add an automatic pixel placement feature that matches a template image.
+        E.g. Implement prioritization of important areas first, like outlines or text.
+        E.g. Allow configuration of rate limits to avoid getting banned.
+    validations:
+      required: true
+  - type: textarea
+    id: feature-alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: "Describe any alternative solutions or features you've considered."
+      placeholder: |
+        E.g. Manually placing pixels myself.
+        E.g. Using a different bot that doesn't support template images.
+        E.g. Semi-automatic scripts that still require manual correction.
+    validations:
+      required: false
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here. If your feature is based on "something," please add any links relative to that "something" here.
+      placeholder: |
+        E.g. A sample template image the bot should replicate.
+        E.g. A video of the bot in action or a similar tool online.
+        E.g. Notes on color palette, priority zones, or timing restrictions.

.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

@@ -0,0 +1,28 @@
+# Pull Request
+Fill out the following details to submit your PR.
+
+## Summary
+Please briefly describe the changes in your PR.
+E.g. Fixes display bug with templates.
+E.g. Adds a template tab that users can manage all templates through.
+
+## Related Issue(s)
+Link to the related issues your PR would solve here.
+E.g. Fixes #14
+E.g. Adds #4
+
+## Changes
+Select the type of change your PR is:
+- [ ] Feature
+- [ ] Bug fix
+- [ ] Documentation
+- [ ] Refactoring
+- [ ] Build
+- [ ] Other
+
+## Checklist
+- [ ] This PR follows the project's style of coding and documentation.
+- [ ] Auto-Bot has been verified to work correctly for this PR.
+
+## Additional Notes
+Anything else reviewers should know?

.github/workflows/cd.yml

@@ -0,0 +1,187 @@
+name: Pages – aggregate all branches
+
+on:
+  push:
+    branches: ["**"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  aggregate_deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+
+    steps:
+      - name: Checkout (shallow)
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Aggregate and build recursive directory pages
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          # jq for JSON escaping (present on runners, but ensure)
+          if ! command -v jq >/dev/null 2>&1; then
+            sudo apt-get update -y
+            sudo apt-get install -y jq
+          fi
+
+          REPO="${GITHUB_REPOSITORY#*/}"
+          SITE_ROOT="/${REPO}/"
+
+          mkdir -p public
+          : > public/.nojekyll
+
+          # Tiny favicon assets to avoid 404s
+          printf "%s" \
+            "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><text y='14' font-size='14'>🚀</text></svg>" \
+            > public/favicon.svg
+
+          # List remote branches
+          mapfile -t BRANCHES < <(
+            git ls-remote --heads origin | awk '{print $2}' \
+            | sed 's@refs/heads/@@'
+          )
+
+          # Landing page (no globals except window.__branches)
+          cat > public/index.html <<'HTML'
+          <!doctype html>
+          <meta charset="utf-8" />
+          <meta name="viewport" content="width=device-width,initial-scale=1" />
+          <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ctext y='14' font-size='14'%3E🚀%3C/text%3E%3C/svg%3E" />
+          <title>Branches</title>
+          <style>
+            body{font-family:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Arial;
+                 margin:24px;background:#0d1117;color:#e6edf3}
+            a{color:#58a6ff;text-decoration:none}
+            .card{background:#161b22;padding:16px;border-radius:8px;margin:12px 0}
+            input{background:#0b0f14;border:1px solid #30363d;color:#e6edf3;
+                  padding:8px 10px;border-radius:6px;width:100%;max-width:420px}
+          </style>
+          <h1>Branches</h1>
+          <input id="q" placeholder="Filter branches..." />
+          <div id="list"></div>
+          <script>window.__branches=window.__branches||[];</script>
+          HTML
+
+          # Emit index.html for a directory
+          gen_index_dir() {
+            local DIR="$1" ROOT="$2" BR="$3"
+            local rel="${DIR#$ROOT}"
+            local title="Branch: ${BR}${rel:-/}"
+
+            {
+              echo "<!doctype html><meta charset='utf-8'/>"
+              echo "<meta name='viewport' content='width=device-width,initial-scale=1'/>"
+              echo "<link rel='icon' href=\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ctext y='14' font-size='14'%3E🚀%3C/text%3E%3C/svg%3E\" />"
+              echo "<title>${title}</title>"
+              echo "<style>body{font-family:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Arial;margin:24px;background:#0d1117;color:#e6edf3}a{color:#58a6ff;text-decoration:none}table{width:100%;border-collapse:collapse}th,td{padding:8px;border-bottom:1px solid #30363d}tr:hover{background:#161b22}</style>"
+              echo "<h1>${title}</h1>"
+              if [[ "$DIR" != "$ROOT" ]]; then
+                echo "<p><a href='../'>⬆ Up</a> • <a href='${SITE_ROOT}'>All branches</a></p>"
+              else
+                echo "<p><a href='${SITE_ROOT}'>All branches</a></p>"
+              fi
+              echo "<table><thead><tr><th>Name</th><th style='width:120px'>Size</th><th style='width:180px'>Modified</th></tr></thead><tbody>"
+
+              # Subdirectories
+              while IFS= read -r d; do
+                [[ -n "$d" ]] || continue
+                printf "<tr><td>📁 <a href='./%s/'>%s/</a></td><td>—</td><td>—</td></tr>\n" "$d" "$d"
+              done < <(find "$DIR" -mindepth 1 -maxdepth 1 -type d -printf '%f\n' | sort)
+
+              # Files
+              while IFS= read -r f; do
+                [[ -n "$f" ]] || continue
+                size=$(stat -c %s "$DIR/$f" 2>/dev/null || echo 0)
+                size_h=$(numfmt --to=iec --suffix=B "$size" 2>/dev/null || echo "$size")
+                mod=$(date -r "$DIR/$f" "+%Y-%m-%d %H:%M" 2>/dev/null || echo "")
+                printf "<tr><td>📄 <a href='./%s'>%s</a></td><td>%s</td><td>%s</td></tr>\n" "$f" "$f" "$size_h" "$mod"
+              done < <(find "$DIR" -mindepth 1 -maxdepth 1 -type f ! -name 'index.html' -printf '%f\n' | sort)
+
+              echo "</tbody></table>"
+              echo "<p style='opacity:.7'>Generated $(date -u '+%Y-%m-%d %H:%M UTC')</p>"
+            } > "$DIR/index.html"
+          }
+
+          # Build per-branch trees and indexes
+          for BR in "${BRANCHES[@]}"; do
+            SAFE="$(echo "$BR" | tr '/:@ ' '----' | sed 's/[^A-Za-z0-9._-]/-/g')"
+            mkdir -p "public/$SAFE"
+
+            git fetch --depth=1 origin "$BR"
+            git archive --format=tar FETCH_HEAD | tar -x -C "public/$SAFE"
+
+            # Keep only static assets; prune empty dirs
+            rm -rf "public/$SAFE/.git" "public/$SAFE/.github" \
+                   "public/$SAFE/node_modules"
+            find "public/$SAFE" -type f ! \
+              \( -name '*.html' -o -name '*.js' -o -name '*.css' -o \
+                 -name '*.json' -o -name '*.png' -o -name '*.jpg' -o \
+                 -name '*.jpeg' -o -name '*.gif' -o -name '*.svg' \) \
+              -delete
+            find "public/$SAFE" -type d -empty -delete
+
+            ROOT_DIR="public/$SAFE"
+            while IFS= read -r -d '' d; do
+              gen_index_dir "$d" "$ROOT_DIR" "$BR"
+            done < <(find "$ROOT_DIR" -type d -print0)
+
+            # Append to landing page (JSON-escaped)
+            SAFE_JSON=$(printf '%s' "$SAFE" | jq -Rr @json)
+            BR_JSON=$(printf '%s' "$BR" | jq -Rr @json)
+            echo "<script>window.__branches.push({safe:$SAFE_JSON,name:$BR_JSON});</script>" \
+              >> public/index.html
+          done
+
+          # Finish landing page
+          cat >> public/index.html <<'HTML'
+          <script>
+            (() => {
+              const q = document.getElementById('q');
+              const listEl = document.getElementById('list');
+
+              function render(filter = '') {
+                listEl.innerHTML = '';
+                const qv = filter.toLowerCase();
+                for (const b of (window.__branches || []).filter(x =>
+                  x.name.toLowerCase().includes(qv)
+                )) {
+                  const div = document.createElement('div');
+                  div.className = 'card';
+                  div.innerHTML = `<strong>${b.name}</strong><div>
+                    <a href="./${b.safe}/">Open</a>
+                  </div>`;
+                  listEl.appendChild(div);
+                }
+              }
+
+              q.addEventListener('input', (e) => render(e.target.value));
+              render();
+            })();
+          </script>
+          HTML
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: public
+
+      - name: Deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,18 @@
+# Node modules
+node_modules/
+
+# NPM/Yarn lock
+package-lock.json
+package.json
+
+# Prettier
+.prettierrc.json
+
+# ESLint
+eslint.config.cjs
+
+# Staged changes
+staged_changes.diff
+
+# IDE (WebStorm/IntelliJ IDEA)
+.idea/