weeks of bullshit

flash/src/main/java/dev/relism/extension/ExtensionPhase.java

@@ -0,0 +1,32 @@
+package dev.relism.extension;
+
+/**
+ * Semantic execution phases for {@link FlashExtension#priority()}.
+ *
+ * <p>Phase determines the order in which annotation-processor middlewares are injected into
+ * the chain. Lower value = runs earlier (outermost wrapper = first at request time).
+ *
+ * <pre>
+ * Request ──► EARLY middlewares ──► DEFAULT middlewares ──► LATE middlewares ──► handler
+ * </pre>
+ *
+ * <p>Within the same phase, extensions execute in install order (sort is stable).
+ * Raw integers are valid for fine-grained ordering within a phase
+ * (e.g. {@code ExtensionPhase.EARLY.value + 10}).
+ */
+public enum ExtensionPhase {
+
+    /** Security guards, rate limiting — must short-circuit before expensive processing. */
+    EARLY(100),
+
+    /** Normal application extensions. Default when {@link FlashExtension#priority()} is not overridden. */
+    DEFAULT(500),
+
+    /** Observability, logging, diagnostics — must observe after all business logic. */
+    LATE(900);
+
+    /** The integer priority value used for sorting. */
+    public final int value;
+
+    ExtensionPhase(int value) { this.value = value; }
+}