@esankhan3/code-search-mcp 0.0.2 → 0.2.0

package/dist/projects/registry.js

@@ -0,0 +1,146 @@
+import { readdirSync, existsSync, statSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import {
+  resolveCodeSearchConfig
+} from "../core/config.js";
+const DEFAULT_QUOTAS = {
+  maxQueriesPerMinute: 100,
+  maxEmbeddingCostUsd: 0,
+  maxLlmCostUsd: 0
+};
+function parseSimpleYaml(src) {
+  const obj = {};
+  const lines = src.split(/\r?\n/);
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i].replace(/#.*$/, "").replace(/\s+$/, "");
+    if (!line.trim()) {
+      i++;
+      continue;
+    }
+    const top = /^(\w+):\s*(.*)$/.exec(line);
+    if (!top) {
+      i++;
+      continue;
+    }
+    const key = top[1];
+    const valRaw = top[2];
+    if (!valRaw) {
+      const sub = {};
+      i++;
+      while (i < lines.length) {
+        const sline = lines[i].replace(/#.*$/, "").replace(/\s+$/, "");
+        if (!sline) {
+          i++;
+          continue;
+        }
+        const indent = sline.length - sline.trimStart().length;
+        if (indent < 2) break;
+        const m = /^\s*(\w+):\s*(.*)$/.exec(sline);
+        if (!m) {
+          i++;
+          continue;
+        }
+        sub[m[1]] = coerce(m[2]);
+        i++;
+      }
+      obj[key] = sub;
+    } else {
+      obj[key] = coerce(valRaw);
+      i++;
+    }
+  }
+  return obj;
+}
+function coerce(raw) {
+  let v = raw.trim();
+  if (v.startsWith('"') && v.endsWith('"') || v.startsWith("'") && v.endsWith("'")) return v.slice(1, -1);
+  if (v === "true") return true;
+  if (v === "false") return false;
+  if (/^-?\d+$/.test(v)) return parseInt(v, 10);
+  if (/^-?\d+\.\d+$/.test(v)) return parseFloat(v);
+  if (v.startsWith("[") && v.endsWith("]")) return v.slice(1, -1).split(",").map((s) => coerce(s.trim()));
+  return v;
+}
+function readProjectYaml(path) {
+  if (!existsSync(path)) return {};
+  try {
+    return parseSimpleYaml(readFileSync(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+class ProjectRegistry {
+  constructor(dataDir) {
+    this.dataDir = dataDir;
+  }
+  projects = /* @__PURE__ */ new Map();
+  /** Re-read the projects/ directory. */
+  reload() {
+    this.projects.clear();
+    const projectsDir = join(this.dataDir, "projects");
+    if (!existsSync(projectsDir)) return [];
+    for (const name of readdirSync(projectsDir)) {
+      const dir = join(projectsDir, name);
+      try {
+        if (!statSync(dir).isDirectory()) continue;
+      } catch {
+        continue;
+      }
+      const yamlPath = join(dir, "project.yaml");
+      const meta = readProjectYaml(yamlPath);
+      if (!meta.workspace) continue;
+      const workspaceDir = String(meta.workspace);
+      const quotas = {
+        maxQueriesPerMinute: meta.quotas?.max_queries_per_minute ?? meta.quotas?.maxQueriesPerMinute ?? DEFAULT_QUOTAS.maxQueriesPerMinute,
+        maxEmbeddingCostUsd: meta.quotas?.max_embedding_cost_usd ?? meta.quotas?.maxEmbeddingCostUsd ?? DEFAULT_QUOTAS.maxEmbeddingCostUsd,
+        maxLlmCostUsd: meta.quotas?.max_llm_cost_usd ?? meta.quotas?.maxLlmCostUsd ?? DEFAULT_QUOTAS.maxLlmCostUsd
+      };
+      const config = resolveCodeSearchConfig({ workspaceDir });
+      this.projects.set(name, {
+        name,
+        workspaceDir,
+        repos: Array.isArray(meta.repos) ? meta.repos : [],
+        scopes: Array.isArray(meta.scopes) ? meta.scopes : [],
+        config,
+        quotas
+      });
+    }
+    return [...this.projects.values()];
+  }
+  list() {
+    return [...this.projects.values()];
+  }
+  get(name) {
+    return this.projects.get(name);
+  }
+}
+function projectAccessAllowed(project, identityScopes) {
+  if (project.scopes.length === 0) return true;
+  if (identityScopes.includes("*")) return true;
+  for (const s of identityScopes) {
+    if (project.scopes.includes(s)) return true;
+  }
+  return false;
+}
+const projectRateBuckets = /* @__PURE__ */ new Map();
+function checkProjectQuota(project, identity) {
+  if (project.quotas.maxQueriesPerMinute <= 0) return { ok: true };
+  const key = `${identity}|${project.name}`;
+  const now = Date.now();
+  const bucket = projectRateBuckets.get(key);
+  if (!bucket || now > bucket.resetAt) {
+    projectRateBuckets.set(key, { count: 1, resetAt: now + 6e4 });
+    return { ok: true };
+  }
+  if (bucket.count >= project.quotas.maxQueriesPerMinute) {
+    return { ok: false, reason: `quota exceeded for project="${project.name}": ${project.quotas.maxQueriesPerMinute}/min` };
+  }
+  bucket.count++;
+  return { ok: true };
+}
+export {
+  ProjectRegistry,
+  checkProjectQuota,
+  projectAccessAllowed
+};

package/dist/resources/resources.js

@@ -1,8 +1,8 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { getKnowledgeBasePath } from "../core/config.js";
-import { loadAllProfiles } from "../core/repo-profiler.js";
-import { loadProfile } from "../core/repo-profiler.js";
+import { getKnowledgeBasePath } from "@esankhan3/anvil-knowledge-core";
+import { loadAllProfiles } from "@esankhan3/anvil-knowledge-core";
+import { loadProfile } from "@esankhan3/anvil-knowledge-core";
 function registerResources(ctx) {
   return [
     {

package/dist/server.js

@@ -13,9 +13,10 @@ import { registerGraphTools, handleGraphTool } from "./tools/graph.js";
 import { registerProfileTools, handleProfileTool } from "./tools/profile.js";
 import { registerIndexTools, handleIndexTool } from "./tools/index-tools.js";
 import { registerResources, handleResource } from "./resources/resources.js";
-import { getKnowledgeBasePath } from "./core/config.js";
-import { indexFromPath } from "./core/indexer.js";
+import { getKnowledgeBasePath } from "@esankhan3/anvil-knowledge-core";
+import { indexFromPath } from "@esankhan3/anvil-knowledge-core";
 import { loadServerConfig } from "./core/env-config.js";
+import { toKnowledgeConfig } from "./core/config.js";
 import { startHttpTransport } from "./transports/http-transport.js";
 function createMcpServerInstance(ctx) {
   const server = new Server(
@@ -185,9 +186,12 @@ async function trackedIndex(ctx, project, dirPath, opts) {
   ctx.indexing.startedAt = Date.now();
   ctx.indexing.error = null;
   pushHistory(ctx, "start", `${label}: started for "${project}" at ${dirPath}`);
+  const unified = loadServerConfig().__unified;
+  const knowledgeConfig = toKnowledgeConfig(unified);
   try {
     const stats = await indexFromPath(project, dirPath, {
       force: opts?.force,
+      config: knowledgeConfig,
       onProgress: (m) => {
         ctx.indexing.message = m;
         console.error(`[${label}] ${m}`);

package/dist/tools/graph.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-import { getKnowledgeBasePath } from "../core/config.js";
+import { getKnowledgeBasePath } from "@esankhan3/anvil-knowledge-core";
 function registerGraphTools() {
   return [
     {

package/dist/tools/index-tools.js

@@ -1,4 +1,4 @@
-import { KnowledgeIndexer } from "../core/indexer.js";
+import { KnowledgeIndexer } from "@esankhan3/anvil-knowledge-core";
 const TOOL_NAMES = ["index_status"];
 function registerIndexTools() {
   return [

package/dist/tools/profile.js

@@ -1,5 +1,5 @@
-import { loadAllProfiles, loadProfile } from "../core/repo-profiler.js";
-import { discoverRepos } from "../core/indexer.js";
+import { loadAllProfiles, loadProfile } from "@esankhan3/anvil-knowledge-core";
+import { discoverRepos } from "@esankhan3/anvil-knowledge-core";
 function registerProfileTools() {
   return [
     {

package/dist/tools/search.js

@@ -1,4 +1,4 @@
-import { getRetriever } from "../core/indexer.js";
+import { getRetriever } from "@esankhan3/anvil-knowledge-core";
 function registerSearchTools() {
   return [
     {

package/dist/transports/http-transport.js

@@ -2,9 +2,11 @@ import { createServer } from "node:http";
 import { randomUUID } from "node:crypto";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { createAuthMiddleware } from "../middleware/auth.js";
+import { registry, metrics } from "../observability/metrics.js";
 async function startHttpTransport(opts) {
   const { config, createMcpServer, onReady, getHealth } = opts;
   const authenticate = createAuthMiddleware(config);
+  const startedAt = Date.now();
   const sessions = /* @__PURE__ */ new Map();
   const SESSION_TTL_MS = 30 * 60 * 1e3;
   const MAX_SESSIONS = 100;
@@ -37,6 +39,42 @@ async function startHttpTransport(opts) {
       res.end(JSON.stringify(status, null, 2));
       return;
     }
+    if (path === "/version" && req.method === "GET") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({
+        name: "code-search-mcp",
+        version: "0.1.0",
+        node: process.version,
+        platform: process.platform
+      }));
+      return;
+    }
+    if (path === "/ready" && req.method === "GET") {
+      const health = getHealth?.() ?? {};
+      const ready = health.indexReady === true;
+      res.writeHead(ready ? 200 : 503, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ready, ...health }));
+      return;
+    }
+    if (path === "/metrics" && req.method === "GET") {
+      const status = opts.getStatus?.() ?? {};
+      const indexing = status.indexing;
+      metrics.indexAge.set(0, { phase: indexing?.phase ?? "idle" });
+      res.writeHead(200, { "Content-Type": "text/plain; version=0.0.4" });
+      res.end(registry.render());
+      return;
+    }
+    if (path === "/admin/api/status" && req.method === "GET") {
+      const status = opts.getStatus?.() ?? {};
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({
+        version: "0.1.0",
+        uptime: Math.floor((Date.now() - startedAt) / 1e3),
+        sessions: sessions.size,
+        ...status
+      }, null, 2));
+      return;
+    }
     if (path === "/index" && req.method === "POST") {
       if (config.authEnabled) {
         const identity = authenticate(req, res);

package/package.json

@@ -1,33 +1,52 @@
 {
   "name": "@esankhan3/code-search-mcp",
-  "version": "0.0.2",
+  "version": "0.2.0",
   "description": "MCP server for multi-repo code search — GitHub org or local path, zero config",
   "type": "module",
   "license": "MIT",
   "bin": {
-    "code-search-mcp": "./dist/index.js"
+    "code-search-mcp": "./dist/index.js",
+    "code-search": "./dist/cli/index.js",
+    "code-search-daemon": "./dist/daemon/index.js"
   },
   "exports": {
     ".": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "scripts/smoke"
   ],
   "scripts": {
     "build": "node build.mjs",
-    "dev": "tsc -b --watch"
+    "dev": "tsc -b --watch",
+    "test": "node --test dist/__tests__/*.test.js",
+    "smoke": "bash scripts/smoke/run-smoke.sh"
   },
   "dependencies": {
-    "@lancedb/lancedb": "0.27.2",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "graphology": "0.26.0",
-    "graphology-communities-louvain": "2.0.2",
-    "graphology-metrics": "2.4.0",
-    "graphology-types": "0.24.8",
-    "tree-sitter-wasms": "0.1.13",
-    "web-tree-sitter": "0.26.8"
+    "@esankhan3/anvil-agent-core": "^0.2.0",
+    "@esankhan3/anvil-knowledge-core": "^0.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "optionalDependencies": {
+    "@lancedb/lancedb-darwin-arm64": "0.27.2",
+    "@lancedb/lancedb-darwin-x64": "0.27.2",
+    "@lancedb/lancedb-linux-x64-gnu": "0.27.2",
+    "@lancedb/lancedb-linux-arm64-gnu": "0.27.2",
+    "@lancedb/lancedb-win32-x64-msvc": "0.27.2"
   },
   "devDependencies": {
     "@types/node": "^22.15.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/esanmohammad/Anvil.git",
+    "directory": "packages/code-search-mcp"
+  },
+  "homepage": "https://github.com/esanmohammad/Anvil/tree/main/packages/code-search-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/esanmohammad/Anvil/issues"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/scripts/smoke/run-smoke.sh

@@ -0,0 +1,167 @@
+#!/usr/bin/env bash
+# code-search-mcp end-to-end smoke (T1–T8 from the standalone product plan).
+#
+# Runs the same eight checks we used while landing the P0–P8 work. Requires:
+#   - Ollama running on $OLLAMA_HOST (default http://localhost:11434) with
+#     `bge-m3` and `qwen2.5-coder:7b` pulled (re-rank step).
+#   - The bundle built (`npm -w @esankhan3/code-search-mcp run build`).
+#
+# Optional envs picked up by individual cases:
+#   - OPENAI_API_KEY → T5 OpenAI embedding path
+#   - GEMINI_OAUTH_CREDS=~/.gemini/oauth_creds.json → T5b Gemini path
+#
+# Exit non-zero on the first failure. The script is idempotent: every case
+# writes under $TMP/ and cleans up its own state at the start.
+
+set -u
+cd "$(dirname "$0")/../.."   # → packages/code-search-mcp
+
+TMP="${TMP:-/tmp/cs-smoke}"
+DIST_CLI="$PWD/dist/cli/index.js"
+DIST_MCP="$PWD/dist/index.js"
+DIST_DAEMON="$PWD/dist/daemon/index.js"
+
+if [[ ! -f "$DIST_CLI" || ! -f "$DIST_MCP" || ! -f "$DIST_DAEMON" ]]; then
+  echo "FATAL: dist/ missing — run \`npm -w @esankhan3/code-search-mcp run build\` first" >&2
+  exit 64
+fi
+
+PASS=0
+FAIL=0
+SKIP=0
+
+pass() { echo "  ✓ $*"; PASS=$((PASS+1)); }
+fail() { echo "  ✗ $*" >&2; FAIL=$((FAIL+1)); }
+skip() { echo "  - $* (skipped)";       SKIP=$((SKIP+1)); }
+hdr()  { echo; echo "── $* ──"; }
+
+# ── Setup: minimal pet-shop repo ─────────────────────────────────────────────
+hdr "Setup"
+rm -rf "$TMP"
+mkdir -p "$TMP/pet-shop/src" "$TMP/index"
+cat > "$TMP/pet-shop/src/auth.ts" <<'EOF'
+export function verifyToken(token: string, secret: string): boolean { return token.length > 0 && secret.length > 0; }
+export function requireScope(scope: string, scopes: string[]): void { if (!scopes.includes(scope)) throw new Error('forbidden'); }
+EOF
+cat > "$TMP/pet-shop/src/pets.ts" <<'EOF'
+export interface Pet { id: string; name: string; available: boolean }
+const pets = new Map<string, Pet>();
+export function listAvailablePets(): Pet[] { return [...pets.values()].filter((p) => p.available); }
+export function adoptPet(id: string): Pet { const p = pets.get(id); if (!p) throw new Error('not found'); p.available = false; return p; }
+EOF
+( cd "$TMP/pet-shop" && git init -q && git config user.email t@t.t && git config user.name t && git add -A && git commit -q -m initial ) || { fail "git init"; exit 1; }
+pass "pet-shop fixture committed"
+
+# Common envs for the rest of the smoke.
+export CODE_SEARCH_DATA_DIR="$TMP/index"
+export CODE_SEARCH_EMBEDDING_PROVIDER=ollama
+export CODE_SEARCH_EMBEDDING_MODEL=bge-m3
+export CODE_SEARCH_EMBEDDING_DIMENSIONS=1024
+export CODE_SEARCH_RERANKER_PROVIDER=none
+export CODE_SEARCH_LLM_MODE=none
+export CODE_SEARCH_DAEMON_DISABLED=1
+
+# ── T1: --print-config ───────────────────────────────────────────────────────
+hdr "T1: --print-config"
+OUT="$(CODE_SEARCH_EMBEDDING_PROVIDER=ollama node "$DIST_CLI" --print-config --retrieval.max-chunks 12 2>&1)" || { fail "exited non-zero"; }
+echo "$OUT" | grep -q '"provider": "ollama"' && pass "env layer applied" || fail "embedding.provider != ollama"
+echo "$OUT" | grep -q '"maxChunks": 12'     && pass "CLI flag applied"  || fail "retrieval.maxChunks != 12 (CLI flag override)"
+
+# ── T2: code-search index against real Ollama ───────────────────────────────
+hdr "T2: index pet-shop (Ollama bge-m3)"
+OUT="$(node "$DIST_CLI" index "$TMP/pet-shop" --project petshop 2>&1)" || { fail "indexer exited non-zero"; echo "$OUT" >&2; }
+echo "$OUT" | grep -q '"chunks":' && pass "indexer printed chunks summary" || fail "indexer summary missing"
+echo "$OUT" | grep -q 'DEPRECATED: CODE_SEARCH_LLM_MODE' && fail "F1 regression — stale ANVIL_LLM_MODE warning fired" || pass "F1: no stale legacy-env warning"
+
+# ── T3: query (vector + bm25 baseline; reranker disabled) ───────────────────
+hdr "T3: code-search query"
+OUT="$(node "$DIST_CLI" query "adopt pet" --project petshop --mode vector --top-k 1 --format json 2>&1)" || { fail "vector query failed"; }
+echo "$OUT" | grep -q '"filePath": "src/pets.ts"' && pass "vector query surfaced pets.ts" || fail "vector query did not surface pets.ts"
+OUT="$(node "$DIST_CLI" query "adoptPet" --project petshop --mode bm25 --top-k 1 --format json 2>&1)" || { fail "bm25 query failed"; }
+echo "$OUT" | grep -q '"filePath": "src/pets.ts"' && pass "bm25 query surfaced pets.ts" || fail "bm25 query did not surface pets.ts"
+
+# ── T4: status reports the index ────────────────────────────────────────────
+hdr "T4: status"
+OUT="$(node "$DIST_CLI" status --project petshop 2>&1)"
+echo "$OUT" | grep -q '"embeddingProvider": "ollama"' && pass "embeddingProvider=ollama" || fail "status embeddingProvider mismatch"
+echo "$OUT" | grep -q '"totalChunks":'              && pass "totalChunks reported"     || fail "totalChunks missing"
+
+# ── T5: issue #6 — env vars reach the embedder (provider switch) ────────────
+hdr "T5: env-vars-reach-embedder (issue #6 reproduction)"
+if [[ -n "${OPENAI_API_KEY:-}" ]]; then
+  OUT="$(CODE_SEARCH_DATA_DIR="$TMP/index-openai" CODE_SEARCH_EMBEDDING_PROVIDER=openai CODE_SEARCH_EMBEDDING_MODEL=text-embedding-3-small CODE_SEARCH_EMBEDDING_DIMENSIONS=512 CODE_SEARCH_EMBEDDING_API_KEY="$OPENAI_API_KEY" node "$DIST_CLI" index "$TMP/pet-shop" --project petshop-openai 2>&1)"
+  # Either embedding succeeds (real key) OR we get OpenAI's auth error
+  # (placeholder key). Both prove the env var reached the embedder.
+  if echo "$OUT" | grep -qE '("chunks":|api.openai.com|OpenAI embedding request)'; then
+    pass "OpenAI embedder constructed + called (env vars threaded through)"
+  else
+    fail "OpenAI embedder didn't run"; echo "$OUT" | tail -5 >&2
+  fi
+else
+  skip "T5 OpenAI path — set OPENAI_API_KEY to verify"
+fi
+
+# ── T6: vector-space mismatch guard ─────────────────────────────────────────
+hdr "T6: vector-space mismatch guard"
+OUT="$(CODE_SEARCH_EMBEDDING_PROVIDER=openai CODE_SEARCH_EMBEDDING_API_KEY=stub-key node "$DIST_CLI" query "adopt pet" --project petshop --mode vector --top-k 1 --format json 2>&1)" || true
+echo "$OUT" | grep -q 'Vector-space mismatch' && pass "guard refused the cross-provider query" || fail "guard did not fire on provider mismatch"
+
+# ── T7: daemon round-trip ───────────────────────────────────────────────────
+hdr "T7: daemon round-trip"
+unset CODE_SEARCH_DAEMON_DISABLED
+DAEMON_LOG="$TMP/daemon.log"
+node "$DIST_DAEMON" --workspace "$TMP/pet-shop" > "$DAEMON_LOG" 2>&1 &
+DAEMON_PID=$!
+sleep 6
+if kill -0 "$DAEMON_PID" 2>/dev/null; then
+  pass "daemon process alive (pid $DAEMON_PID)"
+  SOCKET="$TMP/index/daemon/pet-shop.sock"
+  test -S "$SOCKET" && pass "UDS socket present" || fail "socket missing at $SOCKET"
+  OUT="$(node "$DIST_CLI" query "adopt pet" --project pet-shop --mode vector --top-k 1 --format json 2>&1)"
+  echo "$OUT" | grep -q '"filePath": "src/pets.ts"' && pass "query through daemon succeeded" || fail "daemon-backed query failed"
+  echo "// touched $(date)" >> "$TMP/pet-shop/src/pets.ts"
+  sleep 3
+  grep -q 'reindex queued' "$DAEMON_LOG" && pass "watcher debounce-reindexed on file touch" || fail "watcher didn't fire"
+  kill "$DAEMON_PID" 2>/dev/null
+  for _ in 1 2 3 4 5; do
+    kill -0 "$DAEMON_PID" 2>/dev/null || break
+    sleep 1
+  done
+  kill -9 "$DAEMON_PID" 2>/dev/null || true
+  wait "$DAEMON_PID" 2>/dev/null || true
+else
+  fail "daemon exited prematurely"; tail -10 "$DAEMON_LOG" >&2
+fi
+export CODE_SEARCH_DAEMON_DISABLED=1
+
+# ── T8: HTTP server endpoints ───────────────────────────────────────────────
+hdr "T8: HTTP serve"
+PORT=$(( ( RANDOM % 1000 ) + 4100 ))
+HTTP_LOG="$TMP/http.log"
+CODE_SEARCH_PORT="$PORT" CODE_SEARCH_HOST=127.0.0.1 CODE_SEARCH_TRANSPORT=streamable-http node "$DIST_MCP" --serve --project petshop > "$HTTP_LOG" 2>&1 &
+HTTP_PID=$!
+sleep 5
+if kill -0 "$HTTP_PID" 2>/dev/null; then
+  for ep in health ready version metrics admin/api/status; do
+    code="$(curl -s -o /dev/null -w '%{http_code}' "http://127.0.0.1:${PORT}/${ep}")"
+    if [[ "$code" == "200" ]]; then pass "GET /$ep → 200"; else fail "GET /$ep → $code"; fi
+  done
+  curl -s "http://127.0.0.1:${PORT}/metrics" | grep -q '^# HELP code_search_queries_total' \
+    && pass "/metrics emits Prom text format" || fail "/metrics missing prelude"
+  kill "$HTTP_PID" 2>/dev/null
+  for _ in 1 2 3 4 5; do
+    kill -0 "$HTTP_PID" 2>/dev/null || break
+    sleep 1
+  done
+  kill -9 "$HTTP_PID" 2>/dev/null || true
+  wait "$HTTP_PID" 2>/dev/null || true
+else
+  fail "HTTP server failed to start"; tail -10 "$HTTP_LOG" >&2
+fi
+
+# ── Summary ─────────────────────────────────────────────────────────────────
+echo
+echo "──────────────────────────────────────────"
+echo "PASS: $PASS    FAIL: $FAIL    SKIP: $SKIP"
+echo "──────────────────────────────────────────"
+exit $(( FAIL == 0 ? 0 : 1 ))