From 19fe53d4e5c5f1037d7dac6b20dc4f23e7c9d56b Mon Sep 17 00:00:00 2001
From: Pierre <worph@users.noreply.github.com>
Date: Sat, 10 Jan 2026 19:15:00 +0100
Subject: [PATCH] bugfix

---
 src/index.ts | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/index.ts b/src/index.ts
index a1db0dc..23e8d45 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,3 +1,26 @@
+/**
+ * MetaMesh Plugin: filename-parser
+ *
+ * ============================================================================
+ * PLUGIN MOUNT ARCHITECTURE - DO NOT MODIFY WITHOUT AUTHORIZATION
+ * ============================================================================
+ *
+ * Each plugin container has exactly 3 mounts (2 for plugins without output):
+ *
+ *   1. /files              (READ-ONLY)  - Shared media files, read access only
+ *   2. /cache              (READ-WRITE) - Plugin-specific cache folder
+ *   3. /files/plugin/<id>  (READ-WRITE) - Plugin output folder (if needed)
+ *
+ * This plugin (filename-parser) only requires mount 2:
+ *   - /cache (RW) - to cache parsed filename results
+ *   - Note: This plugin parses filenames from metadata, doesn't read files
+ *
+ * SECURITY: Plugins must NEVER write to /files directly.
+ * All write operations go to /cache or /files/plugin/<id> only.
+ *
+ * ============================================================================
+ */
+
 import Fastify from 'fastify';
 import type { HealthResponse, ProcessRequest, ProcessResponse, CallbackPayload, ConfigureRequest, ConfigureResponse } from './types.js';
 import { manifest, process as processFile } from './plugin.js';