1 contributor
# 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.
- `AGENTS.md`: Safety rules for agents or unattended automation that copy, derive, or run the importer.
- `INCIDENTS.md`: Postmortems for data-loss or near-data-loss incidents and the regression rules derived from them.
- `sample/`: Contains local media fixtures used for development and testing. **Note:** Scripts and functions are not imported from sample directories.
## 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, source, or derive importer behavior from sample directories.
- Use sample media only for testing and development reference.
- Do not use removed Raspberry Pi / unattended wrapper prototypes as a reference design; they were based on an outdated, unvalidated importer copy.
- 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.