fix(docker,release): multi-stage frontend build, asset distribution, and bump to v2.17.1

.dockerignore

@@ -0,0 +1,14 @@
+.git
+.venv
+venv
+data/
+node_modules/
+frontend/node_modules/
+frontend/dist/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+*.pyc
+__pycache__/
+*.log

.github/workflows/docker-publish.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Set up Node.js 20
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
           cache: 'npm'
           cache-dependency-path: frontend/package-lock.json
 

.gitignore

@@ -11,6 +11,6 @@ venv/
 htmlcov/
 *.log
 node_modules/
-.vitepress/dist/
-.vitepress/cache/
-dist/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+/dist/

ARCHITECTURE.md

@@ -1,4 +1,4 @@
-# Architecture: ContextCortex (v2.17.0)
+# Architecture: ContextCortex (v2.17.1)
 
 ContextCortex provides fast, local, syntax-aware semantic and hybrid search over codebases, git repositories, markdown notes, architecture documents, and system documentation. It is built natively on the **Model Context Protocol (MCP) SDK 2.0.0+** using `FastMCP`, with an integrated FastAPI web engine, real-time diagnostic logging, pluggable relational and vector store backends (PostgreSQL 16 with pgvector, Qdrant, ChromaDB, and SQLite), automatic polling daemons, multi-provider webhooks, interactive dependency topology graph explorer, RFC 9728 OAuth 2.1 Protected Resource Server, 3-tier API key RBAC, and a React 19 administrative dashboard.
 

DEVELOPER_DOCS.md

@@ -1,4 +1,4 @@
-# Developer Documentation: ContextCortex (v2.17.0)
+# Developer Documentation: ContextCortex (v2.17.1)
 
 This document provides instructions for developing, testing, configuring, and running ContextCortex locally.
 

Dockerfile

@@ -1,5 +1,14 @@
-FROM python:3.11-slim
+# Stage 1: Build Frontend
+FROM node:22-alpine AS frontend-builder
+WORKDIR /app/frontend
+RUN apk add --no-cache git
+COPY frontend/package*.json ./
+RUN npm ci
+COPY frontend/ ./
+RUN npm run build
 
+# Stage 2: Runtime Environment
+FROM python:3.11-slim
 WORKDIR /app
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
@@ -14,6 +23,8 @@ COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 
 COPY . .
+COPY --from=frontend-builder /app/frontend/dist ./frontend/dist
+COPY --from=frontend-builder /app/frontend/dist ./www
 
 EXPOSE 3000
 

README.md

@@ -1,4 +1,4 @@
-# ContextCortex (v2.17.0)
+# ContextCortex (v2.17.1)
 
 
 [![Build and Publish Docker Image](https://github.com/spelech/contextcortex/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/spelech/contextcortex/actions/workflows/docker-publish.yml)

REQUIREMENTS.md

@@ -1,8 +1,8 @@
-# Software Requirements Specification: ContextCortex (v2.17.0)
+# Software Requirements Specification: ContextCortex (v2.17.1)
 
 > **Note:** This document is automatically generated and verified against the live test suite by `scripts/generate_requirements.py` and `tests/backend/test_requirements_sync.py`.
 
-**Test Verification Baseline:** **1032 Automated Tests** (679 Pytest Backend + 303 Vitest Frontend + 50 Playwright E2E).
+**Test Verification Baseline:** **1033 Automated Tests** (680 Pytest Backend + 303 Vitest Frontend + 50 Playwright E2E).
 
 ---
 
@@ -573,10 +573,11 @@ classDiagram
 - `test_git_syncer_nonexistent_repo`
 - `test_git_progress_tracker_pending_cancellation`
 
-#### `tests/backend/test_health_check_status.py` (3 tests)
+#### `tests/backend/test_health_check_status.py` (4 tests)
 - `test_api_stats_reports_healthy_when_store_is_healthy`
 - `test_api_stats_reports_unhealthy_when_store_fails`
 - `test_api_stats_reports_healthy_with_real_embedded_store` - _Verify /admin/api/stats health check against a real embedded Qdrant vector store without mocks._
+- `test_main_app_favicon_and_root_redirect` - _Verify root app redirect, favicon routes, and static asset handling._
 
 #### `tests/backend/test_indexer_and_embeddings.py` (25 tests)
 - `test_embeddings_generation`

app/services/git_manager.py

@@ -137,7 +137,8 @@ def sanitize_url_for_logging(url: str) -> str:
     **os.environ,
     "GIT_TERMINAL_PROMPT": "0",
     "GIT_ASKPASS": "",
-    "SSH_ASKPASS": ""
+    "SSH_ASKPASS": "",
+    "GIT_CONFIG_PARAMETERS": "'http.https://github.com/.extraheader='",
 }
 
 def get_remote_head_sha(

docs/TEST_COVERAGE.md

@@ -1,4 +1,4 @@
-# Test Coverage Report: ContextCortex (v2.17.0)
+# Test Coverage Report: ContextCortex (v2.17.1)
 
 This document provides comprehensive test coverage metrics and verification baselines for ContextCortex following the modular architectural restructuring, Codebase Navigator implementation, and test suite expansion.
 

docs/reference/rest-api.md

@@ -16,7 +16,7 @@ All administrative routes are prefixed with `/admin/api`.
   ```json
   {
     "status": "ok",
-    "version": "2.17.0",
+    "version": "2.17.1",
     "database": "connected",
     "vector_store": "healthy"
   }

frontend/.oxlintrc.json

@@ -4,5 +4,6 @@
   "rules": {
     "react/rules-of-hooks": "error",
     "react/only-export-components": ["warn", { "allowConstantExport": true }]
-  }
+  },
+  "ignorePatterns": ["dist/**"]
 }

frontend/dist/assets/array-BifhSqXX.js

@@ -0,0 +1 @@
+Array.prototype.slice;function e(e){return typeof e==`object`&&`length`in e?e:Array.from(e)}export{e as t};