feat(static-assets): cache-bust JS/CSS via ?v=<commit-sha>, immutable in prod

Adds a `static_v(request, name, path=...)` Jinja helper that appends
?v=<commit-sha> from app.core.build_info, plus a CachedStaticFiles
subclass that serves Cache-Control: public, max-age=31536000, immutable
in production and no-cache in development. Browsers refetch JS/CSS
automatically on every deploy without the user having to hard-reload.

- New: app/core/static_files.py (CachedStaticFiles)
- Updated: app/templates_config.py (static_v helper)
- Updated: main.py (use CachedStaticFiles for *_static mounts)
- Codemod: 143 url_for('*_static', path='*.js'|'*.css') → static_v(...)
  across 123 templates. Images/fonts/JSON locales intentionally
  unchanged (out of scope).
- Arch rule: FE-024 (warning) flags raw url_for on JS/CSS to prevent
  drift. Note: FE-008 was already taken by the number_stepper rule.
- docs/proposals/static-asset-cache-busting.md marked Done.

Closes plan from docs/proposals/static-asset-cache-busting.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app/modules/tenancy/templates/tenancy/admin/admin-user-detail.html

@@ -271,5 +271,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-user-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-user-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/admin-user-edit.html

@@ -353,5 +353,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-user-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-user-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/admin-users.html

@@ -283,5 +283,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-users.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-users.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/login.html

@@ -210,6 +210,6 @@
     </script>
 
     <!-- 6. Login Logic -->
-    <script defer src="{{ url_for('core_static', path='admin/js/login.js') }}"></script>
+    <script defer src="{{ static_v(request, 'core_static', path='admin/js/login.js') }}"></script>
 </body>
 </html>

app/modules/tenancy/templates/tenancy/admin/merchant-detail.html

@@ -483,5 +483,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-edit.html

@@ -490,5 +490,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-user-detail.html

@@ -281,5 +281,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-user-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-user-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-user-edit.html

@@ -247,5 +247,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-user-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-user-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-users.html

@@ -250,5 +250,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-users.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-users.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchants.html

@@ -257,5 +257,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchants.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchants.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platform-create.html

@@ -233,5 +233,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platform-create.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platform-create.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platform-detail.html

@@ -221,5 +221,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platform-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platform-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platform-edit.html

@@ -342,5 +342,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platform-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platform-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platform-menu-config.html

@@ -223,5 +223,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platform-menu-config.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platform-menu-config.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platform-modules.html

@@ -303,5 +303,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platform-modules.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platform-modules.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/platforms.html

@@ -123,5 +123,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/platforms.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/platforms.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/select-platform.html

@@ -177,7 +177,7 @@
     <script defer src="{{ url_for('static', path='shared/js/utils.js') }}"></script>
     <script defer src="{{ url_for('static', path='shared/js/api-client.js') }}"></script>
     <script defer src="{{ url_for('static', path='shared/js/icons.js') }}"></script>
-    <script defer src="{{ url_for('tenancy_static', path='admin/js/select-platform.js') }}"></script>
+    <script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/select-platform.js') }}"></script>
     <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.13.3/dist/cdn.min.js"></script>
 </body>
 </html>

app/modules/tenancy/templates/tenancy/admin/store-create.html

@@ -279,5 +279,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/store-create.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/store-create.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/store-detail.html

@@ -661,5 +661,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/store-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/store-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/store-edit.html

@@ -477,5 +477,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/store-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/store-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/store-roles.html

@@ -267,5 +267,5 @@
 <script>
     window._adminStoreRolesConfig = { isSuperAdmin: {{ is_super_admin | tojson }} };
 </script>
-<script defer src="{{ url_for('tenancy_static', path='admin/js/store-roles.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/store-roles.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/stores.html

@@ -248,5 +248,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/stores.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/stores.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/user-create.html

@@ -191,5 +191,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/user-create.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/user-create.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/merchant/login.html

@@ -211,6 +211,6 @@
     </script>
 
     <!-- 6. Merchant Login Logic -->
-    <script defer src="{{ url_for('core_static', path='merchant/js/login.js') }}"></script>
+    <script defer src="{{ static_v(request, 'core_static', path='merchant/js/login.js') }}"></script>
 </body>
 </html>

app/modules/tenancy/templates/tenancy/merchant/team.html

@@ -534,5 +534,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='merchant/js/merchant-team.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='merchant/js/merchant-team.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/store/login.html

@@ -246,7 +246,7 @@
     </script>
 
     <!-- 7. Store Login Logic -->
-    <script defer src="{{ url_for('tenancy_static', path='store/js/login.js') }}"></script>
+    <script defer src="{{ static_v(request, 'tenancy_static', path='store/js/login.js') }}"></script>
 
 </body>
 </html>

app/modules/tenancy/templates/tenancy/store/profile.html

@@ -202,5 +202,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='store/js/profile.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='store/js/profile.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/store/roles.html

@@ -163,5 +163,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='store/js/roles.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='store/js/roles.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/store/settings.html

@@ -1328,5 +1328,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='store/js/settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='store/js/settings.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/store/team.html

@@ -299,5 +299,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='store/js/team.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='store/js/team.js') }}"></script>
 {% endblock %}