Agent Notes

Media importer lineage

AutoNAS derives its unattended camera import behavior from:

/Users/bogdan/Documents/Workspaces/Bogdan/Media Importer/media-importer.sh

Before changing scripts/autonas-media-importer.sh, read the upstream note:

/Users/bogdan/Documents/Workspaces/Bogdan/Media Importer/AGENTS.md

The Raspberry Pi importer/wrapper direction from the old Media Importer repo is a dead end and must not be used as a reference design unless that direction is explicitly reopened.

Unattended safety rules

AutoNAS runs from udev/systemd and is therefore unattended by default. Changes must preserve the upstream data-loss protections:

• no overwrite of existing destination files;
• destination conflicts resolved before copy/move;
• planned destination paths reserved during one run;
• move mode implemented as copy, verify, then delete source;
• source deletion only after destination verification succeeds;
• destination temp files cleaned on copy/verify failures;
• VERIFY_MODE=size default with strict available;
• GoPro timestamp changes require regression testing against real MP4/THM/LRV cases.

If any of these protections are missing, do not recommend AutoNAS unattended import.

Required validation

For importer changes, compare behavior with upstream media-importer.sh and, when possible, run upstream tests:

cd "/Users/bogdan/Documents/Workspaces/Bogdan/Media Importer"
./test_runner.sh timestamp-collision
./test_runner.sh verify-mode
./test_runner.sh dest-in-source
./test_runner.sh gopro-sidecar-sync
./test_runner.sh gopro-no-sidecar-reimport

If these cannot be run, mark the AutoNAS importer as partially validated only.