Vibe C Compiler (v1.5.10)

---

🛠️ Human C Compiler

The stable, human-governed evolution of the Vibe C project.

This repository is the official development home for the DOM5-web team. While our sister repo (the Vibe Hub) serves as an experimental sandbox for AI agents, this fork is where we refine that logic into a structured, readable, and reliable C compiler.

---

👥 For Developers

If you are part of the human dev team, this is your home base. ### Our Mission:

1. Curate the Vibes: We take the best autonomous breakthroughs from the Hub and refactor them for humans.
2. Architecture First: We prioritize clean code, documentation, and stable builds over raw AI velocity.
3. Safety & Standards: Unlike the experimental Hub, all code here must pass human peer review.
4. ROADMAP: Please check out the ROADMAP as it is a todo list of all things and tesks that are in need of completion.

---

🔄 The Pipeline

We periodically "Sync" with the Vibe C Hub.

• The Hub = R&D / AI Exploration (Jules & CodeRabbit)
• The Fork = Production / Human Engineering (DOM5-web)

📜 License

Maintained under the original project license. See LICENSE for details.

The Vibe C Compiler is a project management and compilation suite designed to make C development easier and more intuitive than using GCC directly. It wraps around Clang to provide seamless cross-compilation support and project directory management.

Note

THIS CODE IS AI GENERATED. This repo is a copy of gtref/Vibe_c_compiler

Features

• Global Installation: Use vcc command from anywhere after running install.
• Simple CLI: Easy commands like init, build, run, test, install, uninstall, audit, update, and upgrade.
• Fast Incremental Builds & Tests: Optimized for speed with parallel execution, efficient NO-OP checks, and cached header scanning (v1.4.4).
• Parallel and Incremental Test Execution: High-speed testing that only recompiles changed tests and runs them concurrently with pre-filtered NO-OP checks (v1.4.2).
• Binary Hardening: Automatically applies security hardening flags (stack protection, PIE, RELRO) to all builds and tests (v1.4.5).
• High-Performance Security Audit: Features a parallelized, regex-based detection system with $O(\log N)$ line-numbering for rapid vulnerability scanning (v1.4.6).
• Audit Reliability: Improved scanner accuracy with word-boundary matching to prevent syntactic bypasses (v1.4.7).
• Expanded Auditing: Includes the compiler's own internal headers in security scans and detects more unsafe patterns (v1.4.8).
• Network Security Hardening: Implemented SOMAXCONN backlogs and zero-initialization of network structures to mitigate DoS and information leakage (v1.5.0).
• Thread Pool Robustness: Added comprehensive error handling (malloc, pthread_create), atomic initialization/cleanup, and $O(1)$ job insertion to the worker thread pool (v1.5.1).
• Thread Pool Hardening: Enforces a strict 1024 thread limit and shutdown-aware job rejection to mitigate DoS and prevent memory leaks (v1.5.5-v1.5.10).
• Constant-Time String Security: Hardened vibe_str_eq_constant_time to avoid string length leakage via a single-pass implementation (v1.5.6).
• JSON Stack Hardening: Implemented recursive depth tracking and hardened printing macros in JSON serialization (v1.5.10).
• File I/O Hardening: Enforced 10MB size limits and added robust error handling for vibe_read_file to mitigate OOM/DoS (v1.5.10).
• Regex NULL Safety: Implemented NULL pointer checks in vibe_regex_match to prevent application crashes (v1.5.2).
• Optimized XOR Cipher: Replaced modulo operator with incremental indexing and specialized SWAR paths for significantly improved performance (v1.5.2-v1.5.7).
• Secure JSON Printing: Built-in JSON printing with full control character escaping and high-performance chunked I/O (v1.4.7).
• Compile-time Format String Hardening: Enforces string literals in printing macros to prevent format string injection at the source (v1.5.1).
• Secure Memory Primitives: Added vibe_secure_memzero to ensure sensitive data can be securely wiped from memory (v1.4.8).
• Library Robustness: Core headers include NULL pointer checks for increased stability (v1.4.7-v1.5.10).
• Project Management: Manages your project structure (src/, build/, vibe.json).
• Interactive Menu: A simple TUI for those who prefer menus.
• High-Performance Scanning: Uses os.scandir for rapid file discovery across all commands (v1.4.4).
• Cross-Compilation: Easily target any architecture supported by Clang.
• Library Support: Effortlessly create static and shared libraries.
• 25 Custom Headers: Built-in headers for advanced features (SIMD, Math, Networking, UI, etc.).

Quick Start

1. Initialize a project:

   ./vibe_c_compiler init my_cool_project
   cd my_cool_project

2. Install Globally:

   ./vibe_c_compiler install

   Now you can use vcc instead of ./vibe_c_compiler.

3. Build and Run:

   vcc run

4. Uninstall Globally:

   vcc uninstall

5. Open the Menu:

   vcc menu

6. Run Security Audit:

   vcc audit

7. Update Compiler:

   vcc update  # or vcc upgrade

Documentation

See Documentation for full details on headers and advanced usage.

---

Project Navigation

• Home (README)
• Documentation
• Developer Docs
• Security Policy
• Contributing Guidelines
• Contributors
• Code of Conduct