arc-raiders-autoscrapper

Use when user wants to Run the Arc Raiders AutoScrapper validation stack after edits. Use for linting, typing, tests, workflow checks, and broader repo validation.

Use when user wants to Update Metaforge snapshots and bundled default rules

Use when user wants to Validate OCR changes against failure corpus before shipping

Add a new OCR regression fixture from an ocr_debug image. Use when a scan misidentified an item and you want to lock in the correct result as a test case.

Use when user wants to Run full validation, push branch, and open a PR with appropriate context notes

Workflow for safely adding, removing, or renaming persisted config fields in config.py. Use whenever editing dataclass fields in src/autoscrapper/config.py. Covers incrementing CONFIG_VERSION, writing a migration function, and validating the round-trip.

Use when user wants to Find and remove genuine dead code using deadcode + vulture. Filters known false positives (dataclass fields, protocol methods, dunder hooks). Run before a cleanup commit.

Use when user wants to Replay OCR corpus against a candidate threshold value to validate before shipping a threshold change. Use specifically for changes to fuzzy match threshold or score_cutoff. For general OCR code changes, use /ocr-corpus-replay instead.

Fetch Arc Raiders game data from the MetaForge community API - items, quests, ARCs, traders, and event timers.

Use when user wants to Sync fork from upstream (zappybiby/ArcRaiders-AutoScrapper) before pushing. Run this before any push or PR creation to avoid merge conflicts.

Use when user wants to Run the full validation suite (lint + types + tests) before marking any code change done.

Use when user wants to Analyze OCR failure corpus to find systematic misreads, top error patterns, and whether unlisted items need rules added

Use when user wants to Summarize the last dry-run scan output from /tmp/scan-diag.txt and classify failures by type

Use when user wants to Context for diagnosing scans where OCR read items correctly but sell/recycle decisions were wrong - rule precedence, fuzzy threshold, progress overrides

Use when user wants to Full new-game-patch pipeline - fetch Metaforge data, regenerate default rules, run verify, report items with no rule coverage.

Use when user wants to Triage guide for scans where item labels show "UNAVAILABLE" - root cause is context-menu OCR fuzzy-matching the game's greyed-out button label as the item name, not a missing action enum

Use when user wants to Context for debugging OCR misreads - coordinate spaces, preprocessing pipeline, cache state, and common failure patterns in inventory_vision.py

Use when user wants to End-to-end scan failure pipeline - diagnose, identify root cause, fix, corpus replay, verify.

Use when user wants to Benchmark Tesseract tessdata model variants (fast vs best) for accuracy and speed tradeoffs

Use when user wants to Guided workflow for adding or editing a custom item rule in items_rules.json

Create, debug, and optimize GitHub Actions workflows for this Python 3.13 / uv repository.

Run the correct validation checks for changed files in this repository (Python, workflows, guidance, and generated data).

Use when user wants to Safely regenerate progress/data/*.json and items_rules.default.json via the update script

Proactively discover and use MCP servers and MCP tools before native CLI tools. Use when searching, reading, editing, refactoring, planning, or researching so Copilot gets higher-signal results with less context waste

Optimize code for readability, performance, maintainability, and security across Python. Use when asked to improve code quality, optimize performance, add type safety, or refactor for idioms

Write, review, or edit technical documentation for any `.md` files or `docs/` directory. Use when asked to write docs, update README, or improve documentation quality.

Refresh Copilot bootstrap guidance for this Python 3.13 / uv OCR repo. Use when asked to initialize Copilot guidance, update `copilot-setup-steps`, or improve repo-specific agent guidance.

Use when the user wants to commit staged changes, sync with upstream, merge into main, and push to the fork. Triggers on "merge my changes", "push to remote", "commit and push", "merge into main", "sync local changes", "get my changes onto main", "sync with upstream", "pull upstream changes", or any request to integrate staged/branch work into main and push. Pulls from upstream first so the fork always contains the latest game data and CI-generated files, then applies local changes on top and pushes to Ven0m0/arc-raiders-autoscrapper. Never pushes to the upstream repo.

Workflow for recalibrating the context-menu crop constants in inventory_vision.py. Use when the context menu is being cropped at the wrong position, missed entirely, or when the game UI layout changes. Constants are normalized to 1920x1080.

Fetch Arc Raiders game data from the MetaForge community API - items, quests, ARCs (enemies), traders, and event timers. Use when you need to: look up item stats/rarity/value/workbench by type or rarity; find quest requirements and rewards by trader; check trader buy prices; or get upcoming in-game event schedules. Base URL: https://metaforge.app/api/arc-raiders. No auth required. Attribution to metaforge.app/arc-raiders required in public projects. Commercial use requires contacting MetaForge via Discord first.

Diagnose and fix pre-commit hook failures in this repo. Covers rumdl frontmatter, stale staged entries, and large-file check issues.

Safe workflow for changing fuzzy-match threshold or OCR confidence cutoff values. Use whenever editing threshold/score_cutoff in core/item_actions.py or ocr/inventory_vision.py. Corpus replay required before shipping - see T001.