feat: add orchestrator pipeline, TopicRegistry, and CI improvements

- Add TopicRegistry to centralize queue topic configuration and
  decouple controllers from subscription details
- Refactor consumer to accept TopicRegistry instead of raw queue +
  subscriber name
- Add request controller to orchestrator pipeline with publisher for
  forwarding to next stage
- Generate gomock mocks for consumer, queue, publisher, and subscriber
  interfaces
- Simplify server startup by removing retry loops (rely on Docker
  Compose healthchecks via --wait)
- Auto-tail container logs to stderr during integration/e2e tests
- Fix CI Bazel caching: use disk-cache + repo-cache from .bazelrc,
  per-job cache keys to avoid save races
- Stream test output in real-time (--test_output=streamed)
- Remove redundant .github/actions/logs (logs now stream automatically)
- Consolidate PROJECT_STRUCTURE.md into CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: behinddwalls

.bazelrc

@@ -1 +1,2 @@
 common --disk_cache=~/.cache/bazel-disk-cache
+common --repository_cache=~/.cache/bazel-repo-cache

.github/actions/logs/action.yml

@@ -1,5 +1,5 @@
 name: Run Bazel Test
-description: Run Bazel test and show logs on failure
+description: Run a Bazel test target
 
 inputs:
   target:
@@ -11,7 +11,4 @@ runs:
   steps:
     - name: Run Bazel test
       shell: bash
-      run: ./tool/bazel test ${{ inputs.target }} --test_output=errors
-
-    - uses: ./.github/actions/logs
-      if: always()
+      run: ./tool/bazel test ${{ inputs.target }} --test_output=streamed

.github/actions/run-bazel-test/action.yml

@@ -1,5 +1,17 @@
 name: Setup
-description: Setup Bazel cache for CI jobs
+description: Setup Bazel caches for CI jobs
+
+# Caches three directories that match the paths configured in .bazelrc:
+#   - disk-cache:  compiled build outputs (biggest speedup — avoids recompilation)
+#   - repo-cache:  downloaded external dependencies (avoids re-downloading Go modules, protobuf, etc.)
+#   - bazelisk:    the Bazel binary itself
+#
+# Cache key includes github.job so each CI job saves its own cache entry
+# (otherwise concurrent jobs race on the same key and only one wins).
+# github.run_id ensures the key never matches exactly, forcing actions/cache
+# to always save — so the disk cache accumulates entries across runs.
+# The restore-keys fallback restores from the most recent prior run of the
+# same job (preferred), then same deps, then any.
 
 runs:
   using: composite
@@ -8,8 +20,11 @@ runs:
       uses: actions/cache@v4
       with:
         path: |
-          ~/.cache/bazel
+          ~/.cache/bazel-disk-cache
+          ~/.cache/bazel-repo-cache
           ~/.cache/bazelisk
-        key: bazel-${{ runner.os }}-${{ hashFiles('MODULE.bazel', 'go.mod', '.bazelversion') }}
+        key: bazel-${{ runner.os }}-${{ github.job }}-${{ hashFiles('MODULE.bazel', 'go.mod', 'go.sum', '.bazelversion', '.bazelrc') }}-${{ github.run_id }}
         restore-keys: |
+          bazel-${{ runner.os }}-${{ github.job }}-${{ hashFiles('MODULE.bazel', 'go.mod', 'go.sum', '.bazelversion', '.bazelrc') }}-
+          bazel-${{ runner.os }}-${{ github.job }}-
           bazel-${{ runner.os }}-

.github/actions/setup/action.yml

@@ -59,8 +59,6 @@ jobs:
       - name: Run E2E tests
         run: make e2e-test
 
-      - uses: ./.github/actions/logs
-
   gateway-integration-test:
     name: Gateway Integration Test
     runs-on: ubuntu-latest
@@ -71,8 +69,6 @@ jobs:
       - name: Run Gateway integration tests
         run: make integration-test-gateway
 
-      - uses: ./.github/actions/logs
-
   orchestrator-integration-test:
     name: Orchestrator Integration Test
     runs-on: ubuntu-latest
@@ -83,8 +79,6 @@ jobs:
       - name: Run Orchestrator integration tests
         run: make integration-test-orchestrator
 
-      - uses: ./.github/actions/logs
-
   # ---------------------------------------------------------------------------
   # EXTENSION TESTS
   # ---------------------------------------------------------------------------