Reorder footer actions and add CI parity gate guidance

Author: gildesmarais

AGENTS.md

@@ -15,6 +15,7 @@ This document defines execution constraints for AI agents. For general contribut
 ## Agent-Specific Verification Rules
 
 - Always run Dev Container smoke + `make ready` for changes.
+- For frontend changes or API contract/spec changes, run `make ci-ready` to mirror CI parity checks.
 - For frontend changes, also verify in `chrome-devtools` MCP at `http://127.0.0.1:4001/` while the Dev Container is running.
 - Capture a quick state check for all affected UI states (e.g., guest/member/result) to enforce state parity and avoid duplicate actions.
 

Makefile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-.PHONY: help test lint lint-js lint-ruby lintfix lintfix-js lintfix-ruby setup dev clean frontend-setup check-frontend quick-check ready yard-verify-public-docs openapi openapi-verify openapi-client openapi-client-verify openapi-lint openapi-lint-redocly openapi-lint-spectral openai-lint-spectral test-frontend-e2e
+.PHONY: help test lint lint-js lint-ruby lintfix lintfix-js lintfix-ruby setup dev clean frontend-setup check-frontend quick-check ready ci-ready yard-verify-public-docs openapi openapi-verify openapi-client openapi-client-verify openapi-lint openapi-lint-redocly openapi-lint-spectral openai-lint-spectral test-frontend-e2e
 
 RUBOCOP_FLAGS ?= --cache false
 
@@ -107,6 +107,13 @@ ready: ## Pre-commit gate (quick checks + RSpec)
 	bundle exec rspec
 	@echo "Pre-commit checks complete!"
 
+ci-ready: ## CI parity gate (ready + OpenAPI verify + frontend e2e smoke)
+	@echo "Running CI parity checks..."
+	$(MAKE) ready
+	$(MAKE) openapi-verify
+	$(MAKE) test-frontend-e2e
+	@echo "CI parity checks complete!"
+
 yard-verify-public-docs: ## Verify essential YARD docs for all public methods in app/
 	bundle exec rake yard:verify_public_docs
 

docs/README.md

@@ -42,6 +42,7 @@ Running the app directly on the host is not supported.
 | `make setup`                   | Install Ruby and Node dependencies.                        |
 | `make dev`                     | Run Ruby (port 4000) and frontend (port 4001) dev servers. |
 | `make ready`                   | Pre-commit gate: `make quick-check` + `bundle exec rspec`. |
+| `make ci-ready`                | CI parity gate: `make ready` + `make openapi-verify` + frontend e2e smoke. |
 | `make test`                    | Run Ruby and frontend test suites.                         |
 | `make lint`                    | Run all linters.                                           |
 | `make yard-verify-public-docs` | Enforce typed YARD docs for public methods in `app/`.      |
@@ -90,6 +91,12 @@ Always run this before pushing or committing:
 make ready
 ```
 
+For frontend changes and API contract/OpenAPI changes, run the CI-parity gate:
+
+```bash
+make ci-ready
+```
+
 ### Testing Layers
 
 | Layer             | Tooling                  | Focus                                                |

frontend/src/__tests__/App.test.tsx

@@ -184,6 +184,8 @@ describe('App', () => {
             feed_token: 'generated-token',
             public_url: '/api/v1/feeds/generated-token',
             json_public_url: '/api/v1/feeds/generated-token.json',
+            created_at: '2026-04-05T08:59:00.000Z',
+            updated_at: '2026-04-05T09:00:00.000Z',
           },
           preview: {
             items: [],
@@ -412,10 +414,10 @@ describe('App', () => {
     expect(utilityItems).toEqual([
       'Try included feeds',
       'Bookmarklet',
+      'Clear saved token',
+      'Install from Docker Hub',
       'OpenAPI spec',
       'Source code',
-      'Install from Docker Hub',
-      'Clear saved token',
     ]);
   });
 
@@ -671,9 +673,9 @@ describe('App', () => {
     expect(utilityLinks).toEqual([
       'Try included feeds',
       'Bookmarklet',
+      'Install from Docker Hub',
       'OpenAPI spec',
       'Source code',
-      'Install from Docker Hub',
     ]);
 
     expect(screen.getByRole('link', { name: 'OpenAPI spec' })).toHaveAttribute(

frontend/src/components/AppPanels.tsx

@@ -275,6 +275,19 @@ export function UtilityStrip({
           Try included feeds
         </a>
         <Bookmarklet />
+        {hasAccessToken && (
+          <button type="button" class="utility-button" onClick={onClearToken}>
+            Clear saved token
+          </button>
+        )}
+        <a
+          href="https://hub.docker.com/r/html2rss/web"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="utility-link"
+        >
+          Install from Docker Hub
+        </a>
         {openapiUrl && (
           <a
             href={normalizedOpenapiUrl ?? openapiUrl}
@@ -293,19 +306,6 @@ export function UtilityStrip({
         >
           Source code
         </a>
-        <a
-          href="https://hub.docker.com/r/html2rss/web"
-          target="_blank"
-          rel="noopener noreferrer"
-          class="utility-link"
-        >
-          Install from Docker Hub
-        </a>
-        {hasAccessToken && (
-          <button type="button" class="utility-button" onClick={onClearToken}>
-            Clear saved token
-          </button>
-        )}
       </div>
     </section>
   );