Harden quarantine provisioning; enforce strict permissions and update Ansible and docs

core/DetectorInterface.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace UploadLogger\Core;
+
+/**
+ * Detectors analyze requests and uploads and return findings.
+ */
+interface DetectorInterface
+{
+    public function getName(): string;
+
+    /**
+     * @param array<string, mixed> $input
+     * @return array<string, mixed> Structured detection output for logging.
+     */
+    public function detect(Context $context, array $input = []): array;
+}