[Patch] Photon v0.1.1

- Added dependency check.

Author: coredex-source

photon/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Photon Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.1] - 2025-11-10
+
+### Added
+- **System Requirements Check** feature from Phase 1 roadmap
+  - New `photon check` command to verify system requirements
+  - Automatic verification before each build
+  - Checks for Rust compiler (1.70.0+), Cargo, Git, and LLVM
+  - Helpful error messages with installation links when requirements are missing
+  - Version detection for all required tools
+  - Distinguishes between critical requirements (Rust, Cargo, Git) and optional (LLVM)
+  - Unit tests for version checking logic
+
+### Changed
+- Updated help documentation to include `photon check` command
+- Enhanced build process to verify system requirements before compilation
+- Updated README.md with system requirements section
+- Updated QUICKSTART.md with system check step
+- Updated SCOPE.md to mark System Requirements Check as complete
+
+### Technical Details
+- New module: `src/system_check.rs`
+- Dependencies: Uses standard library only (no new external dependencies)
+- Cross-platform compatible (Linux, macOS, Windows)
+
+## [0.1.0] - 2025-11-08
+
+### Added
+- Initial release of Photon build tool
+- Cross-platform build support (Linux, macOS, Windows)
+- Multiple build profiles: debug, release, snapshot
+- Binary installation to libs/ with platform-specific naming
+- Git integration for version tracking
+- Clean build artifacts command
+- Beautiful CLI output with ASCII banner
+- Comprehensive help system
+- Version information command
+
+### Features
+- `photon build [profile]` - Build Noviq interpreter
+- `photon clean` - Clean build artifacts
+- `photon install` - Install binaries to libs/
+- `photon help` - Show help information
+- `photon version` - Show version information
+
+---
+
+## Version Format
+
+Photon follows [Semantic Versioning](https://semver.org/):
+- MAJOR.MINOR.PATCH (e.g., 0.1.1)
+- MAJOR: Breaking changes
+- MINOR: New features (backward compatible)
+- PATCH: Bug fixes (backward compatible)

photon/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "photon"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2021"
 description = "Build tool for the Noviq programming language"
 authors = ["Noviq Contributors"]

photon/QUICKSTART.md

@@ -8,7 +8,14 @@
    cargo build --release
    ```
 
-2. **Add to PATH (Optional but recommended)**:
+2. **Check System Requirements**:
+   ```bash
+   ./target/release/photon check
+   ```
+   
+   This verifies you have Rust, Cargo, Git, and other required tools installed.
+
+3. **Add to PATH (Optional but recommended)**:
    ```bash
    # Linux/macOS - Add to ~/.bashrc or ~/.zshrc
    export PATH="$PATH:/path/to/Noviq/photon/target/release"
@@ -63,8 +70,14 @@ photon install
 
 ## Troubleshooting
 
+### "System requirements not met"
+- Run `photon check` to see what's missing
+- Install Rust: https://rustup.rs/
+- Install Git: https://git-scm.com/downloads
+
 ### "cargo: command not found"
 - Install Rust: https://rustup.rs/
+- Make sure `~/.cargo/bin` is in your PATH
 
 ### "Failed to change to Noviq directory"
 - Make sure you're running Photon from the `photon/` directory

photon/README.md

@@ -7,6 +7,7 @@ Photon is a cross-platform build tool written in Rust that compiles the Noviq in
 ## Features
 
 - Fast & Reliable - Built in Rust for performance and safety
+- System Requirements Check - Automatically verifies Rust, Cargo, and Git
 - Multiple Build Profiles - Debug, Release, and Snapshot builds
 - Automatic Installation - Copy built binaries to `libs/` with proper naming
 - Clean Builds - Easy artifact cleanup
@@ -52,6 +53,9 @@ photon build snapshot
 ### Other Commands
 
 ```bash
+# Check system requirements
+photon check
+
 # Clean build artifacts
 photon clean
 
@@ -102,6 +106,10 @@ photon build snapshot
 ## Workflow Example
 
 ```bash
+# 0. Check system requirements first
+cd /path/to/Noviq/photon
+./target/release/photon check
+
 # 1. Make changes to Noviq source code
 cd /path/to/Noviq
 
@@ -132,8 +140,20 @@ Examples:
 
 ## Requirements
 
-- Rust toolchain (for building Photon)
-- Git (for snapshot builds with commit hash)
+Photon automatically checks for the following requirements before building:
+
+- **Rust 1.70.0+** - For compiling Noviq (checked automatically)
+- **Cargo** - Rust's package manager (comes with Rust)
+- **Git** - For snapshot builds with commit hash
+- **LLVM** (optional) - For future JIT support
+
+You can verify your system meets these requirements by running:
+
+```bash
+photon check
+```
+
+If any requirements are missing, Photon will provide installation links and instructions.
 
 ## Integration with Cargo Workspace
 

photon/SCOPE.md

@@ -11,17 +11,20 @@ Transform Photon from a simple build script replacement into a comprehensive dev
 - Binary installation to libs/
 - Git integration for version tracking
 - Clean build artifacts
+- System requirements verification ✓
 
 ## Planned Features
 
 ### Phase 1: Enhanced Build System (v0.2.0)
 
 #### Dependency Management
-- **System Requirements Check**
+- **✓ System Requirements Check** (COMPLETED v0.1.1)
   - Verify Rust toolchain version
   - Check Git availability
   - Validate required system libraries
   - Display helpful error messages with installation links
+  - Automatic verification before builds
+  - Manual check via `photon check` command
 
 - **Build Caching**
   - Track source file changes

photon/src/main.rs

@@ -7,6 +7,8 @@ use std::path::Path;
 use std::process::{Command, exit};
 use std::fs;
 
+mod system_check;
+
 fn main() {
     print_banner();
 
@@ -26,6 +28,7 @@ fn main() {
         }
         "clean" => clean_build(),
         "install" => install_noviq(),
+        "check" => check_system(),
         "help" | "--help" | "-h" => print_help(),
         "version" | "--version" | "-v" => print_version(),
         _ => {
@@ -37,16 +40,21 @@ fn main() {
 }
 
 fn print_banner() {
+    let version = env!("CARGO_PKG_VERSION");
     println!("╔═══════════════════════════════════════╗");
     println!("║           Photon Build Tool           ║");
-    println!("║    Noviq Programming Language v0.1    ║");
+    println!("║   Noviq Programming Language v{}   ║", version);
     println!("╚═══════════════════════════════════════╝");
     println!();
 }
 
 fn print_version() {
-    println!("Photon v0.1.0");
-    println!("Build tool for Noviq Programming Language");
+    let version = env!("CARGO_PKG_VERSION");
+    let name = env!("CARGO_PKG_NAME");
+    let description = env!("CARGO_PKG_DESCRIPTION");
+    
+    println!("{} v{}", name.chars().next().unwrap().to_uppercase().to_string() + &name[1..], version);
+    println!("{}", description);
 }
 
 fn print_help() {
@@ -60,6 +68,7 @@ fn print_help() {
     println!();
     println!("    clean              Clean build artifacts");
     println!("    install            Install built binary to libs/");
+    println!("    check              Check system requirements");
     println!("    help               Show this help message");
     println!("    version            Show version information");
     println!();
@@ -69,6 +78,7 @@ fn print_help() {
     println!("    photon build snapshot     # Snapshot build with git hash");
     println!("    photon clean              # Clean build directory");
     println!("    photon install            # Install to libs/");
+    println!("    photon check              # Verify system requirements");
     println!();
     println!("BUILD PROFILES:");
     println!("    debug      - Unoptimized with debug symbols");
@@ -82,6 +92,13 @@ fn print_help() {
 }
 
 fn build_noviq(profile: &str) {
+    // First, verify system requirements
+    if !system_check::verify_system_requirements(false) {
+        println!();
+        system_check::verify_system_requirements(true);
+        exit(1);
+    }
+    
     println!("[*] Building Noviq ({} mode)...", profile);
     println!();
 
@@ -256,3 +273,43 @@ fn install_noviq() {
         println!("[WARN] No binaries installed. Build Noviq first with 'photon build'");
     }
 }
+
+fn check_system() {
+    println!("[*] Verifying system requirements...");
+    println!();
+    
+    let results = system_check::run_all_checks();
+    let mut all_critical_passed = true;
+    
+    // Print results
+    for result in &results {
+        println!("    {}", result);
+        
+        // Only Rust, Cargo, and Git are critical
+        if !result.passed && result.name != "LLVM" {
+            all_critical_passed = false;
+        }
+    }
+    
+    println!();
+    
+    if all_critical_passed {
+        println!("[✓] All system requirements satisfied!");
+        println!("    You're ready to build Noviq!");
+    } else {
+        println!("[✗] Some critical requirements are missing!");
+        println!();
+        println!("Please install the missing components:");
+        
+        for result in &results {
+            if !result.passed && result.name != "LLVM" {
+                println!("  • {} - {}", result.name, result.message);
+            }
+        }
+        
+        println!();
+        println!("Quick Install Guide:");
+        println!("  Rust & Cargo: https://rustup.rs");
+        println!("  Git:          https://git-scm.com/downloads");
+    }
+}