# Spark Output: Snippet Summarizer Artifacts

Generated: 2026-10-12T13:03:03 UTC

## Files Produced

1. **snippet-summarizer.py** (3,137 bytes)
   - Python utility that scans directories for Python source files
   - Extracts metadata: line count, character count, file size
   - Outputs structured JSON report
   - Usage: `python snippet-summarizer.py <directory> [--output <file>]`

2. **report.json** (16,156 bytes)
   - Generated report scanning `/root/.hermes/profiles/spark/`
   - 50 Python snippets found
   - 11,713 total lines of code
   - 430.78 KB total size
   - Average 234.26 lines per file

## Verification

The report.json file is valid JSON and contains:
- Complete file listing with paths
- Per-file statistics
- Extension-based grouping
- Aggregate statistics

---

# JSON Validator (New Addition)

A Python CLI tool for validating JSON files with detailed error reporting.

## Files

1. **json_validator.py** - Main validation script
2. **sample_valid.json** - Test file (valid object)
3. **sample_array.json** - Test file (valid array)
4. **sample_scalar.json** - Test file (valid string scalar)
5. **sample_bad.json** - Test file (invalid JSON)

## Usage

```bash
python3 json_validator.py <file.json> [file2.json ...]
```

## Verified Tests

```
✓ VALID: sample_valid.json - Object with 3 keys, 73 bytes
✓ VALID: sample_array.json - Array with 3 elements, 141 bytes
✓ VALID: sample_scalar.json - Scalar value: str, 21 bytes
✗ INVALID: sample_bad.json - Missing quotes error
✗ INVALID: nonexistent.json - File not found error
```

---

# quick_stats.py - File Statistics Utility

A simple file statistics utility that reports line count, word count, byte size, and top 5 most common words.

## Files

- **quick_stats.py** - Main script (1,458 bytes)

## Usage

```bash
python3 quick_stats.py <file1> [file2 ...]
```

## Verified Test

```
$ python3 quick_stats.py test_input.txt

=== test_input.txt ===
Bytes:     118
Lines:     5
Words:     22
Unique:    13
Top words: [('hello', 3), ('world', 2), ('the', 2), ('this', 1), ('is', 1)]
```

## Verification

Check: python3 /root/.hermes/wizard-outputs/spark/quick_stats.py /root/.hermes/wizard-outputs/spark/test_input.txt && echo "PASS"

---

# syshealth.py - System Health Check Utility

A Python utility that collects system metrics: disk usage, memory info, load average, and process count.

## Files

- **syshealth.py** - Main script (1,697 bytes)
- **system-report.json** - Generated report with all metrics

## Usage

```bash
python3 syshealth.py
```

## Verified Test

```
$ python3 /root/.hermes/wizard-outputs/spark/check_syshealth.py
PASS: Valid JSON with all required keys
Process count: 422
```

## Verification

Check: python3 /root/.hermes/wizard-outputs/spark/check_syshealth.py && echo "PASS"

---

# JSON Schema Validator (NEW)

A command-line tool for validating JSON files against JSON Schema.

## Files

1. **json_schema_validator.py** - Main validation script (46 lines)
2. **test_schema.json** - Test schema (requires name: string, age: integer >= 0)
3. **test_data_valid.json** - Valid test data, passes validation
4. **test_data_invalid.json** - Invalid test data (age < 0)
5. **test_data_missing.json** - Missing required field test

## Usage

```bash
python3 json_schema_validator.py <schema_file.json> <data_file.json>
```

## Verified Tests

```
✓ VALID: test_data_valid.json passes against test_schema.json (exit 0)
✗ INVALID: test_data_invalid.json fails with "age: -5 is less than minimum of 0" (exit 1)
✗ INVALID: test_data_missing.json fails with "'age' is required" (exit 1)
```

## Verification

Check: python3 /root/.hermes/wizard-outputs/spark/json_schema_validator.py test_schema.json test_data_valid.json && echo "PASS"

---

# URL Title Extractor

A Python utility to extract HTML page titles from URLs with optional caching.

## Files

- **url_title_extractor.py** - Main script (121 lines)
- **test_url_title_extractor.py** - Test suite

## Usage

```bash
python3 url_title_extractor.py <url1> <url2> ...
```

### Options

- `--no-cache` - Disable caching of results
- `--clear-cache` - Clear the title cache

### Examples

```bash
python3 url_title_extractor.py https://example.com
python3 url_title_extractor.py --no-cache https://example.com
```

## Tested Results

```
PASSED: TitleParser - Correctly extracts title from HTML
PASSED: Cache directory - Verified writable location
```

## Verification

Check: python3 /root/.hermes/wizard-outputs/spark/test_url_title_extractor.py && echo "PASS"