# Alloy Repository Archive

This archive contains files that were moved during the repository cleanup and reorganization process. These files were preserved for review and potential future reference.

## Archive Structure

### `old_code/`
Contains the original monolithic implementation that was replaced by the modular structure:
- `alloy_interpreter.py` - Original single-file interpreter implementation
- `demo.py` - Original demo script (functionality moved to `examples/`)

### `temp_tests/`
Contains ad-hoc test files that were created during development:
- `manual_test.py` - Manual testing script
- `quick_test.py` - Quick testing script  
- `simple_test.py` - Simple testing script
- `run_all_tests.py` - Script to run all tests (replaced by pytest)
- `validate_tests.py` - Test validation script

### `build_artifacts/`
Contains generated files from the PLY (Python Lex-Yacc) parser:
- `parser.out` - PLY parser output file
- `parsetab.py` - PLY parser table file
- Note: These files are automatically regenerated when needed

### `notes/`
Contains temporary documentation and implementation notes:
- `CLEAN_AGENT_SYNTAX_CHANGES.md` - Implementation notes for syntax changes
- `TEST_README.md` - Temporary test documentation

### `system/`
Contains cache directories and system files:
- `__pycache__/` - Python bytecode cache
- `.mypy_cache/` - MyPy type checker cache
- `.DS_Store` - macOS system file

## Current Repository Structure

After cleanup, the main repository contains:
- `src/alloy/` - Modular Alloy interpreter implementation
- `tests/` - Organized test suite using pytest
- `docs/` - Official documentation
- `examples/` - Example Alloy programs
- `README.md` - Main project documentation
- `pyproject.toml` - Python project configuration
- `requirements.txt` - Python dependencies

## Notes

- All archived files are preserved in their original state
- The modular structure in `src/alloy/` replaces the monolithic `alloy_interpreter.py`
- The organized test suite in `tests/` replaces the ad-hoc test scripts
- Build artifacts will be regenerated automatically when the parser is used
- Cache directories can be safely deleted as they will be recreated when needed

## Recovery

If you need to restore any of these files to the main repository:
1. Copy the file from the appropriate archive subdirectory
2. Place it in the main repository directory
3. Update any imports or references as needed

Last updated: July 17, 2025