# Media Importer Project

This repository contains the development and testing resources for the `media-importer.sh` script, which is the main product of this project.

## Project Structure

- `media-importer.sh`: The primary script under development and testing.
- `INCIDENTS.md`: Postmortems for data-loss or near-data-loss incidents and the regression rules derived from them.
- `RPI/`: Raspberry Pi integration prototype. This area is currently frozen because Raspberry Pi 3B+ hardware with 1 GB RAM has not provided reliable validation capacity and may also be affected by hardware defects.
- `samples/code/autonas-media-importer.sh`: The original script that serves as inspiration for this project.
- `samples/`: Contains code samples, example files, and other resources used for development and testing. **Note:** Scripts and functions are not imported from this directory; it is strictly for reference and testing purposes.

## Version Control

Version control is implemented for all files except the `samples/` directory. The `samples/` directory is excluded from version control to avoid tracking test resources and sample files.

To exclude the `samples/` directory, the following entry should be added to the `.gitignore` file:

```gitignore
samples/
```

## Contribution Guidelines

- All development should focus on `media-importer.sh`.
- Do not import or source scripts/functions from the `samples/` directory.
- Use resources in `samples/` only for testing and development reference.
- Destination conflicts must never be delegated to copy/move tools. In unattended runs the importer appends numeric suffixes (`_1`, `_2`, ...); in interactive runs it asks the user and supports applying the choice to all similar conflicts.

## License

Specify your license here.

---

For details on recent changes, including the removal of fallback date handling, see [CHANGELOG.md](./CHANGELOG.md).

This file is intended for GitHub Copilot and contributors to understand the project structure and guidelines.