@cachly-dev/mcp-server 0.10.64 → 0.10.66

package/scripts/e2e-run.sh

@@ -1,160 +0,0 @@
-#!/usr/bin/env bash
-# ─────────────────────────────────────────────────────────────────────────────
-# cachly E2E test runner
-#
-# Usage:
-#   ./scripts/e2e-run.sh                 # run all e2e tests
-#   ./scripts/e2e-run.sh api             # only API health + auth tests
-#   ./scripts/e2e-run.sh tools           # only MCP tool tests (needs Redis creds)
-#   ./scripts/e2e-run.sh cli             # only CLI smoke tests
-#   ./scripts/e2e-run.sh funnel          # only funnel telemetry tests
-#   ./scripts/e2e-run.sh provisioning    # provisioning lifecycle (slow, ~5 min)
-#
-# Required env vars:
-#   E2E_API_URL       https://api.dev.cachly.dev   (or prod)
-#   E2E_JWT           <keycloak access token>
-#   E2E_INSTANCE_ID   <uuid of active test Brain>
-#   E2E_API_KEY       <redis password>
-#   E2E_REDIS_HOST    <redis host>
-#
-# Optional:
-#   E2E_REDIS_PORT    6380
-#   E2E_REDIS_TLS     true
-#   E2E_SKIP_SLOW     true   (skip provisioning + device flow)
-# ─────────────────────────────────────────────────────────────────────────────
-
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-cd "$ROOT"
-
-# ── Load .env.test if present (convenience for local dev) ─────────────────────
-if [[ -f "$ROOT/.env.test" ]]; then
-  set -a
-  # shellcheck source=/dev/null
-  source "$ROOT/.env.test"
-  set +a
-  echo -e "\033[90m[e2e] Loaded $ROOT/.env.test\033[0m"
-fi
-
-# ── Defaults ──────────────────────────────────────────────────────────────────
-export E2E_API_URL="${E2E_API_URL:-https://api.cachly.dev}"
-export E2E_REDIS_PORT="${E2E_REDIS_PORT:-6380}"
-export E2E_REDIS_TLS="${E2E_REDIS_TLS:-true}"
-export E2E_SKIP_SLOW="${E2E_SKIP_SLOW:-false}"
-
-# ── Color output ──────────────────────────────────────────────────────────────
-RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; NC='\033[0m'
-
-header() { echo -e "\n${YELLOW}━━━ $1 ━━━${NC}"; }
-ok()     { echo -e "${GREEN}✓ $1${NC}"; }
-fail()   { echo -e "${RED}✗ $1${NC}"; }
-
-# ── Pre-flight checks ─────────────────────────────────────────────────────────
-header "Pre-flight"
-
-if [[ -z "${E2E_JWT:-}" ]]; then
-  fail "E2E_JWT is not set. Export a valid Keycloak token."
-  echo "  Hint: copy your JWT from https://${E2E_API_URL}/api/v1/debug/me after login"
-  exit 1
-fi
-ok "E2E_JWT is set (length: ${#E2E_JWT})"
-
-if [[ -z "${E2E_INSTANCE_ID:-}" ]]; then
-  echo -e "${YELLOW}⚠  E2E_INSTANCE_ID not set — instance-specific tests will be skipped${NC}"
-else
-  ok "E2E_INSTANCE_ID: $E2E_INSTANCE_ID"
-fi
-
-# ── Build ─────────────────────────────────────────────────────────────────────
-header "Building"
-npm run build
-ok "Build complete"
-
-# ── Select test suite ─────────────────────────────────────────────────────────
-SUITE="${1:-all}"
-
-VITEST_BASE="npx vitest run --reporter=verbose"
-E2E_DIR="src/__tests__/e2e"
-
-run_suite() {
-  local name="$1"; local pattern="$2"
-  header "Running: $name"
-  $VITEST_BASE "$pattern" && ok "$name passed" || { fail "$name FAILED"; exit 1; }
-}
-
-case "$SUITE" in
-  api)
-    run_suite "API health + auth" "$E2E_DIR/api-health.test.ts $E2E_DIR/api-auth.test.ts"
-    ;;
-  tools)
-    if [[ -z "${E2E_API_KEY:-}" || -z "${E2E_REDIS_HOST:-}" ]]; then
-      fail "E2E_API_KEY and E2E_REDIS_HOST required for MCP tool tests"
-      exit 1
-    fi
-    run_suite "MCP tools" "$E2E_DIR/mcp-tools.test.ts"
-    ;;
-  cli)
-    run_suite "CLI smoke" "$E2E_DIR/cli.test.ts"
-    ;;
-  funnel)
-    run_suite "Funnel telemetry" "$E2E_DIR/funnel.test.ts"
-    ;;
-  provisioning)
-    export E2E_SKIP_SLOW=false
-    run_suite "Provisioning lifecycle" "$E2E_DIR/provisioning.test.ts"
-    ;;
-  all)
-    header "Running ALL e2e suites"
-
-    echo ""
-    echo "  API URL:      $E2E_API_URL"
-    echo "  Instance ID:  ${E2E_INSTANCE_ID:-(not set)}"
-    echo "  Redis host:   ${E2E_REDIS_HOST:-(not set — tool tests will fail)}"
-    echo "  Skip slow:    $E2E_SKIP_SLOW"
-    echo ""
-
-    FAILED=()
-
-    run_one() {
-      local name="$1"; local file="$2"
-      header "$name"
-      if $VITEST_BASE "$file"; then
-        ok "$name passed"
-      else
-        fail "$name FAILED"
-        FAILED+=("$name")
-      fi
-    }
-
-    run_one "API health (no auth)"  "$E2E_DIR/api-health.test.ts"
-    run_one "API auth + instances"  "$E2E_DIR/api-auth.test.ts"
-    run_one "Funnel telemetry"      "$E2E_DIR/funnel.test.ts"
-    run_one "CLI smoke tests"       "$E2E_DIR/cli.test.ts"
-
-    if [[ -n "${E2E_API_KEY:-}" && -n "${E2E_REDIS_HOST:-}" ]]; then
-      run_one "MCP tools (live Redis)" "$E2E_DIR/mcp-tools.test.ts"
-    else
-      echo -e "${YELLOW}⚠  Skipping MCP tool tests (E2E_API_KEY / E2E_REDIS_HOST not set)${NC}"
-    fi
-
-    if [[ "$E2E_SKIP_SLOW" != "true" ]]; then
-      run_one "Provisioning lifecycle" "$E2E_DIR/provisioning.test.ts"
-    else
-      echo -e "${YELLOW}⚠  Skipping provisioning tests (E2E_SKIP_SLOW=true)${NC}"
-    fi
-
-    echo ""
-    if [[ ${#FAILED[@]} -eq 0 ]]; then
-      echo -e "${GREEN}━━━ ALL E2E TESTS PASSED ━━━${NC}"
-    else
-      echo -e "${RED}━━━ FAILED SUITES: ${FAILED[*]} ━━━${NC}"
-      exit 1
-    fi
-    ;;
-  *)
-    echo "Unknown suite: $SUITE"
-    echo "Usage: $0 [all|api|tools|cli|funnel|provisioning]"
-    exit 1
-    ;;
-esac

package/scripts/generate-icons.js

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-/**
- * Converts SVG icon assets to PNG for Expo.
- * Run: node scripts/generate-icons.js
- * Requires: npm install -g sharp-cli  OR  npx sharp-cli
- */
-const { execSync } = require('child_process');
-const path = require('path');
-
-const frontend = path.join(__dirname, '..', 'apps', 'travel-chaos-organizer', 'frontend');
-
-const conversions = [
-  { input: 'assets/icon.svg', output: 'assets/icon.png', width: 1024, height: 1024 },
-  { input: 'assets/adaptive-icon.svg', output: 'assets/adaptive-icon.png', width: 1024, height: 1024 },
-  { input: 'assets/icon.svg', output: 'assets/splash.png', width: 1284, height: 2778 },
-  { input: 'assets/icon.svg', output: 'assets/favicon.png', width: 32, height: 32 },
-];
-
-for (const { input, output, width, height } of conversions) {
-  const src = path.join(frontend, input);
-  const dst = path.join(frontend, output);
-  try {
-    execSync(`npx sharp-cli --input "${src}" --output "${dst}" resize ${width} ${height}`, { stdio: 'inherit' });
-    console.log(`✓ ${output}`);
-  } catch {
-    console.error(`✗ ${output} — install sharp-cli: npm i -g sharp-cli`);
-  }
-}

package/smithery.yaml

@@ -1,45 +0,0 @@
-name: cachly AI Brain
-description: >
-  Persistent AI memory for Claude Code, Cursor, Copilot, Windsurf, Cline & Zed.
-  Your AI remembers every lesson, fix, and architecture decision — forever.
-  Features: causal root-cause analysis (causal_trace), failure prediction (brain_predict),
-  git-ambient learning (brain_from_git), team knowledge sharing, Memory Crystals,
-  BM25+ search in 11 languages. 80 MCP tools. Free tier. GDPR. German servers.
-  Zero-config: sign in once via browser, auto-provisions your Brain instance.
-
-startCommand:
-  type: stdio
-  configSchema:
-    type: object
-    properties:
-      CACHLY_JWT:
-        type: string
-        title: "API Key (optional — sign in via browser on first use)"
-        description: "Leave blank for zero-config: on your first tool call the server opens a browser sign-in (OAuth Device Flow) and auto-provisions your Brain instance. Or pre-fill with your API key from cachly.dev/setup-ai."
-        examples:
-          - "cky_live_abc123..."
-      CACHLY_BRAIN_INSTANCE_ID:
-        type: string
-        title: "Brain Instance ID (optional)"
-        description: "Only needed if you have multiple Brain instances. Leave blank — the server auto-detects your active instance from the API key."
-        pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
-        examples:
-          - "9d4077aa-bfa2-468b-89cd-0a8d8f3ec483"
-      CACHLY_API_URL:
-        type: string
-        title: "API URL (optional)"
-        description: "Leave blank unless you self-host Cachly."
-        default: "https://api.cachly.dev"
-    required: []
-  commandFunction: |-
-    (config) => ({
-      command: "npx",
-      args: ["-y", "@cachly-dev/mcp-server@latest"],
-      env: Object.fromEntries(
-        Object.entries({
-          CACHLY_JWT: config.CACHLY_JWT,
-          CACHLY_BRAIN_INSTANCE_ID: config.CACHLY_BRAIN_INSTANCE_ID,
-          CACHLY_API_URL: config.CACHLY_API_URL ?? "https://api.cachly.dev",
-        }).filter(([, v]) => v != null && v !== "")
-      )
-    })

package/src/__tests__/auth.test.ts

@@ -1,147 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import { jwtExpiryMs, checkJwt, handleApiError } from '../auth.js';
-
-function makeJwt(payload: Record<string, unknown>): string {
-  const header = Buffer.from(JSON.stringify({ alg: 'HS256', typ: 'JWT' })).toString('base64url');
-  const body   = Buffer.from(JSON.stringify(payload)).toString('base64url');
-  return `${header}.${body}.fakesig`;
-}
-
-const nowSec = () => Math.floor(Date.now() / 1000);
-
-describe('jwtExpiryMs', () => {
-  it('returns null for an empty string', () => {
-    expect(jwtExpiryMs('')).toBeNull();
-  });
-
-  it('returns null for a plain (non-JWT) string', () => {
-    expect(jwtExpiryMs('not-a-token')).toBeNull();
-  });
-
-  it('returns null when the JWT has only two parts', () => {
-    expect(jwtExpiryMs('header.payload')).toBeNull();
-  });
-
-  it('returns null when the JWT has four parts', () => {
-    expect(jwtExpiryMs('a.b.c.d')).toBeNull();
-  });
-
-  it('returns null when the payload base64 is invalid', () => {
-    expect(jwtExpiryMs('header.!!!.sig')).toBeNull();
-  });
-
-  it('returns null when the payload has no exp field', () => {
-    expect(jwtExpiryMs(makeJwt({ sub: 'user-123', iat: nowSec() }))).toBeNull();
-  });
-
-  it('returns null when exp is 0', () => {
-    expect(jwtExpiryMs(makeJwt({ exp: 0 }))).toBeNull();
-  });
-
-  it('converts exp (seconds) to milliseconds', () => {
-    const expSec = nowSec() + 3600;
-    expect(jwtExpiryMs(makeJwt({ exp: expSec }))).toBe(expSec * 1000);
-  });
-
-  it('returns a past timestamp for an expired token', () => {
-    expect(jwtExpiryMs(makeJwt({ exp: nowSec() - 300 }))).toBeLessThan(Date.now());
-  });
-
-  it('returns a future timestamp for a valid token', () => {
-    expect(jwtExpiryMs(makeJwt({ exp: nowSec() + 86400 }))).toBeGreaterThan(Date.now());
-  });
-
-  it('handles a token expiring in less than 60 minutes', () => {
-    const expSec = nowSec() + 30 * 60;
-    const result = jwtExpiryMs(makeJwt({ exp: expSec }))!;
-    const minsLeft = Math.floor((result - Date.now()) / 60_000);
-    expect(minsLeft).toBeGreaterThanOrEqual(29);
-    expect(minsLeft).toBeLessThanOrEqual(30);
-  });
-
-  it('ignores extra claims', () => {
-    const expSec = nowSec() + 3600;
-    expect(jwtExpiryMs(makeJwt({ sub: 'u', iat: nowSec(), exp: expSec, plan: 'free' }))).toBe(expSec * 1000);
-  });
-
-  it('handles padding-free base64url payloads', () => {
-    // base64url (no =) — Buffer.from handles this natively
-    const expSec = nowSec() + 7200;
-    expect(jwtExpiryMs(makeJwt({ exp: expSec, x: 'a' }))).toBe(expSec * 1000);
-  });
-});
-
-describe('checkJwt', () => {
-  it('throws InvalidRequest when jwt is empty', () => {
-    expect(() => checkJwt('')).toThrowError(
-      expect.objectContaining({ code: ErrorCode.InvalidRequest, message: expect.stringContaining('CACHLY_JWT env var not set') }),
-    );
-  });
-
-  it('throws with setup URL when jwt is missing', () => {
-    expect(() => checkJwt('')).toThrowError(
-      expect.objectContaining({ message: expect.stringContaining('cachly.dev/setup-ai') }),
-    );
-  });
-
-  it('throws InvalidRequest with expiry timestamp for an expired token', () => {
-    const expSec = nowSec() - 60;
-    const token  = makeJwt({ exp: expSec });
-    expect(() => checkJwt(token)).toThrowError(
-      expect.objectContaining({
-        code: ErrorCode.InvalidRequest,
-        message: expect.stringContaining('expired at'),
-      }),
-    );
-  });
-
-  it('does not throw for a valid non-expired token', () => {
-    expect(() => checkJwt(makeJwt({ exp: nowSec() + 3600 }))).not.toThrow();
-  });
-
-  it('does not throw for a token with no exp claim', () => {
-    expect(() => checkJwt(makeJwt({ sub: 'user' }))).not.toThrow();
-  });
-});
-
-describe('handleApiError', () => {
-  it('throws InvalidRequest for 401 with the detail message', () => {
-    expect(() => handleApiError(401, 'token expired')).toThrowError(
-      expect.objectContaining({
-        code: ErrorCode.InvalidRequest,
-        message: expect.stringContaining('Authentication failed (401): token expired'),
-      }),
-    );
-  });
-
-  it('throws InvalidRequest for 403 with the detail message', () => {
-    expect(() => handleApiError(403, 'plan limit reached')).toThrowError(
-      expect.objectContaining({
-        code: ErrorCode.InvalidRequest,
-        message: expect.stringContaining('Access denied (403): plan limit reached'),
-      }),
-    );
-  });
-
-  it('throws InternalError for other status codes', () => {
-    expect(() => handleApiError(500, 'server crash')).toThrowError(
-      expect.objectContaining({
-        code: ErrorCode.InternalError,
-        message: expect.stringContaining('cachly API error 500: server crash'),
-      }),
-    );
-  });
-
-  it('includes the cachly.dev/setup-ai link for 401 errors', () => {
-    expect(() => handleApiError(401, 'Unauthorized')).toThrowError(
-      expect.objectContaining({ message: expect.stringContaining('cachly.dev/setup-ai') }),
-    );
-  });
-
-  it('includes account access hint for 403 errors', () => {
-    expect(() => handleApiError(403, 'Forbidden')).toThrowError(
-      expect.objectContaining({ message: expect.stringContaining('access to this resource') }),
-    );
-  });
-});