Let's build NecroGit for Hacktoberfest Week 4 ('Ghost in the Machine'). It needs to unearth deleted git history, run a terminal séance with local Google Gemma 2, render a Día de los Muertos digital remembrance ofrenda with floating marigolds and CRT audio, and operate 100% air-gapped with zero pip/npm dependencies.
Architected and implemented the core system:
- app/git_archaeology.py: Multi-language AST diff parser (-def, -func, -fn) unearthing deleted functions inside surviving files (overcoming standard git log --diff-filter=D limitations).
- app/engine.py: Spectral Inference Router connecting to local Google Gemma 2 via Ollama, guarded by FactValidator to catch hallucinated commit hashes, backed by a 0.02ms deterministic Heuristic Necromancer fallback.
- app/server.py: Zero-dependency ThreadingHTTPServer on port 7777 supporting REST and Server-Sent Events (SSE) token streaming.
- app/cli.py: Full POSIX terminal CLI supporting --scan, --seance, and stdin --haunt Unix pipes.
Build the frontend presentation: an amber phosphor CRT terminal and a candlelit marigold ofrenda altar with procedural audio.
Engineered dual-surface presentation in public/:
- Amber Phosphor CRT: Retro terminal interface with scanlines, screen flicker, and live SSE token streaming.
- Candlelit Digital Ofrenda: 45 canvas-rendered cempasúchil petals with organic wind draft physics, interactive altar tiers, and animated candle flames.
- Procedural Web Audio Engine: Synthesizes 60Hz mains transformer hum, pink noise cemetery wind drafts, mechanical typewriter clicks, and copper singing bowl chimes with zero audio files.
Make sure judges can experience the interactive altar with one click without installing Ollama or cloning the repo. Deploy to GitHub Pages and add a backup mirror on Vercel.
Configured dual 1-click live demo environments:
- Added client-side deterministic fallback engine in public/app.js preloaded with Quake III fast_inverse_sqrt(), Express.js, and React historic code ghosts.
- Deployed primary altar to GitHub Pages: https://xiaoarnav.github.io/necrogit/
- Configured vercel.json with zero-change static routing and deployed edge mirror: https://necrogit.vercel.app/
- Updated GitHub repository About section with both live URLs and topic tags.
Run empirical benchmarks on fact validation accuracy, recall compared to file-level tools, and air-gap latency.
Built and executed eval/benchmark.py across 25 historic code deletions:
- Fact Accuracy: 100.0% commit hash fidelity and author verification (composite 100.0/100 score) via FactValidator.
- Excavation Recall: 4.0x recall gain (functions + classes + files) over file-level history scanners (git log -M).
- Air-Gap Latency: 0.02ms TTFT for offline heuristic fallback, ~120ms for local Gemma 2, exactly 0 bytes network egress.
We encountered three real bugs during development. Document them as honest 'What Went Wrong' confessions.
Documented the engineering hurdles in README and DEV draft:
1. Markdown # Header False-Positive: Lines like - ## Option B matched Python comment boundaries; resolved with CODE_EXTENSIONS whitelist.
2. macOS vs Linux MIME Type Divergence: mimetypes.guess_type() resolved .js to text/javascript on macOS vs application/javascript on Linux; normalized charset and updated test assertions.
3. Gemma Hallucination Drift: High temperature caused Gemma to drift into Linus Torvalds mythology; solved with the 3-way regex FactValidator circuit breaker.
Use the Ian Xiaohei skill to generate a minimalist illustration representing NecroGit.
Generated Ian Xiaohei architectural concept art:
- Xiaohei using mechanical tongs to exhume 0x5f3759df from .git/objects tombstone onto a candlelit ofrenda altar powered by LOCAL GEMMA 2.
- Overhead banner illustrates a severed cloud connection labeled 100% AIR-GAPPED // ZERO CLOUD EGRESS.
- Synchronized to assets/02-necrogit-seance-ofrenda-xiaohei.jpg and embedded in repository documentation.
Should we name a competitor directly in the benchmark comparison, and is the Prize Categories section needed?
Refined submission strategy:
- Neutralized competitor references into technical architectural definitions: File-Level History Scanners (git log -M) vs NecroGit (Function AST Diff Parser), preserving the 4.0x recall advantage without calling out peers.
- Preserved mandatory ## 🏆 Prize Categories section explicitly listing Overall Winner ($250 USD) and Best Use of Gemma ($200 USD) for automated sponsor and judge filtering.
Update the DEV article and README with these points, run tests, and open the preview in Brave Browser.
Synchronized all updates:
- Updated DEV draft (Article ID 4944637) with neutralized tables, prize categories, and quickstart.
- Ran 12/12 unit tests passing in 0.823s.
- Pushed commit 275db61 to origin main with verified author XiaoArnav.
- Opened DEV post draft directly in Brave Browser for review and publish.
Now it's time to publish our this session.
Curating and submitting the complete agent session transcript to DEV under gemini_cli, and embedding the interactive session Liquid tag into the submission article.
