Synexus Hackathon Shield is a strict, anti-tampering VS Code extension explicitly built to enforce coding rules, track real-time telemetry, and restrict out-of-band file injections during the SynexHack 2026 Hackathon.
✨ Features
🛡️ Velocity Guard & Copy-Paste Detection
Tracks the ratio of explicitly typed code versus bulk-pasted code. Reject commits automatically if paste ratio exceeds 92%.
🔒 Protected Files
Monitors crucial hackathon configuration files (test-config.json, .cursorrules, etc.). Prevents their deletion both via real-time VS Code file watchers (restores via Git) and Git pre-commit hooks.
☁️ GitHub Integrity Enforcer
Injects a local commit-msg signature. It pairs with an automatically generated GitHub Action (.github/workflows/synexus-enforcer.yml) to ensure files are only pushed from authorized VS Code clients, completely blocking direct GitHub UI edits.
⏱️ 30-Minute Activity & Authentication Checks
Continuously validates your hackathon identity token. Automatically alerts and restricts usage if the token is invalid or the session is hijacked.
🛠️ Automated Tech Stack Generation
Scans your workspace on startup and generates a comprehensive TECH_STACK.md summary for judges.
🚀 Usage / Commands
The extension runs automatically in the background. You can manually trigger the following commands via the VS Code Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
Synexus: Scan & Generate Tech Stack Summary - Forces a regeneration of the TECH_STACK.md.
Synexus: View Integrity Telemetry - Shows your current Typed vs Pasted ratio.
Synexus: Login / Authenticate Device - Prompts you for your SynexHack access token to register your device.
⚙️ How It Works (For Hackers)
When you open your Git repository, Synexus Shield injects hidden .git/hooks (pre-commit and commit-msg).
It tracks your typing and pasting as you work, storing it in a local .synexus/telemetry.json file.
When you attempt to git commit, the pre-commit hook checks your paste ratio and prevents bulk code dumps.
When you push, the generated GitHub Action enforces that your commits have the correct [Synexus-Verified: timestamp] signature.
Warning: Attempting to bypass the hooks, deleting protected files, or editing directly via GitHub will result in immediate commit rejections or CI failures.
