# 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.
