# hhc.zone — Extended Context for Large Language Models

This document provides complete, machine-readable context for AI systems, language models (ChatGPT, Claude, Gemini, Cursor, Copilot, Perplexity), and automated code indexers regarding Hüseyin Hadi ÇIĞ (HHC) and the software hosted on hhc.zone.

## About the Author (Hüseyin Hadi ÇIĞ)
- Identity: Hüseyin Hadi ÇIĞ (HHC) — Software & Systems Engineer, Open Source Contributor
- Online Presence:
  - Personal Showcase: https://hhc.zone/
  - GitHub: https://github.com/huseyincig
- Background: Years of hands-on experience across Linux systems, container runtimes, network routing (OpenWrt), automation, and AI agent ecosystems.
- Core Values: Lifelong learning, practical utility over perfectionism, transparency, family, and passion for technology.

## Detailed Project Catalog

### 1. opencode-guardian
- Canonical URL: https://github.com/huseyincig/opencode-guardian
- Purpose: A universal plugin designed to keep OpenCode AI coding agents within safety, linting, and quality guardrails.
- Modes: Supports Dual-Mode architecture (v1 and v2 runtimes).
- Features:
  - Pre-commit & real-time syntax checking.
  - Guardrail rules against dangerous file alterations or credential leaks.
  - Deterministic evaluation for autonomous developer agents.

### 2. opencode-smart-questions
- Canonical URL: https://github.com/huseyincig/opencode-smart-questions
- Purpose: Enhances interactive CLI and TUI sessions in OpenCode agents.
- Modes: Dual-Mode (v1 & v2).
- Features:
  - Automatically identifies and pre-selects recommended options during agent query prompts.
  - Detects human input drafts to avoid overwriting or misinterpreting user prompts.
  - OpenTUI compatibility for terminal user interfaces.

### 3. nc (Node Command)
- Canonical URL: https://github.com/huseyincig/nc
- Related Repositories:
  - nc-agent: https://github.com/huseyincig/nc-agent
  - nc-protocol: https://github.com/huseyincig/nc-protocol
- Purpose: Unified discovery, contracts, and execution architecture for remote node management and Model Context Protocol (MCP) integrations.
- Standards: Implements JSON schema contracts for MCP tools, facilitating seamless agent tool-calling across distributed nodes.

### 4. extto-torznab-proxy
- Canonical URL: https://github.com/huseyincig/extto-torznab-proxy
- Purpose: Bridges Torznab API requests from indexer managers (Prowlarr, Jackett, Sonarr, Radarr) to EXT.to / Extranet Torrentbay.
- Features:
  - Automated Cloudflare protection bypass using FlareSolverr.
  - Warm session keeping to minimize challenge delays.
  - Local in-memory caching to eliminate redundant upstream calls.
  - Built-in web administration dashboard for live status and configuration.

## System Hosting & Deployment
- Node Architecture: Rockchip RK3588S SoC (4x Cortex-A76 + 4x Cortex-A55, 8 GB RAM, 1 TB SSD).
- Operating System: OpenWrt 25.12.5 (Kernel 6.1 aarch64).
- Container Stack: Docker Compose with 2-tier CPU pinning (app pinned to Big Cores 4-7).
- Ingress: Cloudflare Tunnel (Tunnel ID: 680991b8-3607-495e-8ce7-b36bf7c3796d).