fa-mcp-sdk 0.4.142 → 0.11.2

package/cli-template/deploy/docker/Dockerfile.local

@@ -0,0 +1,29 @@
+# ── Local development: no in-container build ─────────────────────────────────
+# Assumes dist/ already exists on host (yarn build / yarn cb).
+# Usage: docker compose -f docker-compose.local.yml up -d --build
+FROM node:22-alpine
+
+WORKDIR /app
+
+ENV NODE_TLS_REJECT_UNAUTHORIZED=0
+ENV NODE_ENV=${NODE_ENV}
+
+# Production dependencies only
+COPY package.json yarn.lock ./
+RUN printf "strict-ssl false" > .yarnrc
+RUN yarn install --production=true && yarn cache clean
+
+# Pre-built backend (dist/ must exist on host)
+COPY dist/ ./dist/
+
+# Configs (default.yaml, production.yaml, custom-environment-variables.yaml, etc.)
+COPY config/ ./config/
+
+# External configs (local.yaml) are mounted via volumes in docker-compose.yml.
+
+EXPOSE {{port}}
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \
+  CMD wget --spider -q http://localhost:{{port}}/health || exit 1
+
+ENTRYPOINT ["node", "dist/src/start.js"]

package/cli-template/deploy/docker/README.md

@@ -0,0 +1,94 @@
+# Docker Production Deployment
+
+## Quick Start
+
+```bash
+# 1. Copy and edit config
+cp config/local.docker.yaml config/local.yaml
+# Edit config/local.yaml with your settings (DB, auth tokens, etc.)
+
+# 2. Copy and edit environment
+cp .env.example .env
+# Edit .env (HOST_PORT, SERVICE_NAME, etc.)
+
+# 3. Build and run
+docker compose up -d --build
+```
+
+## Build Only
+
+```bash
+docker compose build
+```
+
+## Run Without Compose
+
+```bash
+docker build -t {{project.name}} -f deploy/docker/Dockerfile .
+
+docker run -d \
+  --name {{project.name}} \
+  -p {{port}}:{{port}} \
+  -e NODE_ENV=production \
+  -e WS_PORT={{port}} \
+  -v $(pwd)/deploy/docker/config/local.yaml:/app/config/local.yaml:ro \
+  {{project.name}}
+```
+
+## Configuration
+
+The container uses `node-config` (the `config` npm package). Config is resolved in this order:
+
+1. `config/default.yaml` — baked into the image
+2. `config/production.yaml` — environment-specific overrides
+3. `config/local.yaml` — **mounted via Docker volume** (your custom settings)
+4. Environment variables — mapped via `config/custom-environment-variables.yaml`
+
+Key environment variables:
+
+| Variable | Config key | Description |
+|----------|-----------|-------------|
+| `WS_PORT` | `webServer.port` | HTTP server port (default: {{port}}) |
+| `WS_HOST` | `webServer.host` | Bind address (default: 0.0.0.0) |
+| `NODE_ENV` | — | Node environment (production) |
+| `DB_HOST` | `db.postgres.dbs.main.host` | PostgreSQL host |
+| `DB_PORT` | `db.postgres.dbs.main.port` | PostgreSQL port |
+| `DB_NAME` | `db.postgres.dbs.main.database` | Database name |
+| `DB_USER` | `db.postgres.dbs.main.user` | Database user |
+| `DB_PASSWORD` | `db.postgres.dbs.main.password` | Database password |
+
+## Health Check
+
+The container includes a built-in health check:
+
+```
+GET http://localhost:{{port}}/health
+```
+
+Response:
+```json
+{
+  "status": "healthy",
+  "details": {
+    "uptime": 123.456,
+    "memoryUsage": { ... },
+    "timestamp": "..."
+  }
+}
+```
+
+## Useful Commands
+
+```bash
+# View logs
+docker compose logs -f app
+
+# Restart
+docker compose restart app
+
+# Stop
+docker compose down
+
+# Rebuild after code changes
+docker compose up -d --build --force-recreate app
+```

package/cli-template/deploy/docker/config/local.docker.yaml

@@ -0,0 +1,14 @@
+---
+
+# Docker-specific configuration overrides.
+# Copy this file to local.yaml and modify as needed:
+#   cp config/local.docker.yaml config/local.yaml
+# local.yaml is mounted into the container at /app/config/local.yaml.
+
+webServer:
+  host: '0.0.0.0'
+  port: {{port}}
+
+logger:
+  level: info
+  useFileLogger: false

package/cli-template/deploy/docker/docker-compose.yml

@@ -0,0 +1,31 @@
+name: {{project.name}}
+
+services:
+  app:
+    container_name: {{project.name}}
+    build:
+      context: ..
+      dockerfile: deploy/docker/Dockerfile
+    image: ${IMAGE_TAG:-{{project.name}}:latest}
+    restart: unless-stopped
+    ports:
+      - "${HOST_PORT:-{{port}}}:{{port}}"
+    environment:
+      - NODE_ENV=${NODE_ENV:-production}
+      - SERVICE_NAME=${SERVICE_NAME:-{{project.name}}}
+      - SERVICE_INSTANCE=${SERVICE_INSTANCE:-prod}
+      - WS_PORT={{port}}
+    volumes:
+      - ./config/local.yaml:/app/config/local.yaml:ro
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "-q", "http://localhost:{{port}}/health"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 60s
+    mem_limit: 2g
+    logging:
+      driver: json-file
+      options:
+        max-size: "50m"
+        max-file: "5"

package/cli-template/deploy/gitlab-runner/.env.example

@@ -0,0 +1,16 @@
+# ── GitLab Runner version ─────────────────────────────────
+GITLAB_VERSION=v18.10.3
+HELPER_VERSION=v18.10.3
+
+# ── GitLab connection ─────────────────────────────────────
+GITLAB_URL=https://gitlab.finam.ru/
+RUNNER_TAGS={{project.name}},docker
+
+# ── Runner identity ──────────────────────────────────────
+RUNNER_NAME={{project.name}}
+RUNNER_TOKEN=
+
+# ── Project directory on host ─────────────────────────────
+# Absolute or relative path to the project root on the server.
+# Defaults to ../../ (two levels up from this directory).
+# PROJECT_DIR=/var/opt/node/{{project.name}}

package/cli-template/deploy/gitlab-runner/README.md

@@ -0,0 +1,65 @@
+# GitLab Runner Setup
+
+Docker-based GitLab Runner for CI/CD pipelines. Uses Docker executor with Docker-out-of-Docker (DooD) pattern.
+
+## How It Works
+
+1. `start.sh` validates `.env`, resolves `PROJECT_DIR`, starts the runner container
+2. `entrypoint.sh` substitutes variables in `config.toml.template` → `config.toml`, starts `gitlab-runner run`
+3. Runner registers with GitLab, listens for CI jobs matching its tags
+
+## Setup
+
+```bash
+# 1. Copy environment template
+cp .env.example .env
+
+# 2. Get runner token from GitLab UI:
+#    Settings → CI/CD → Runners → New project runner
+#    Set tags, then copy the token
+
+# 3. Fill .env with your token and settings
+# Required: GITLAB_URL, RUNNER_NAME, RUNNER_TOKEN
+
+# 4. Start the runner
+bash start.sh
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `GITLAB_VERSION` | yes | v18.10.3 | GitLab Runner Docker image version |
+| `HELPER_VERSION` | yes | v18.10.3 | GitLab Runner Helper image version |
+| `GITLAB_URL` | yes | — | GitLab instance URL |
+| `RUNNER_TAGS` | no | {{project.name}},docker | Comma-separated tags for job matching |
+| `RUNNER_NAME` | yes | — | Runner hostname and container name |
+| `RUNNER_TOKEN` | yes | — | Authentication token from GitLab UI |
+| `PROJECT_DIR` | no | ../../ | Absolute path to project on host |
+
+## Management Commands
+
+```bash
+# Start
+bash start.sh
+
+# View logs
+docker compose logs -f
+
+# Check status
+docker compose exec gitlab-runner gitlab-runner status
+
+# Stop
+docker compose down
+
+# Restart
+docker compose restart
+```
+
+## Infrastructure
+
+- **Network:** `gitlab-network` (bridge)
+- **DNS:** Corporate DNS servers (10.77.96.10, 10.77.196.10)
+- **Executor:** Docker with `docker:27` default image
+- **Volumes:** Docker socket, daemon.json, project directory, /cache
+- **Healthcheck:** `gitlab-runner status` every 60s

package/cli-template/deploy/gitlab-runner/config/config.toml.template

@@ -0,0 +1,26 @@
+concurrent = 2
+check_interval = 0
+shutdown_timeout = 0
+sentry_dsn = ""
+
+[session_server]
+  session_timeout = 1800
+
+[[runners]]
+  name = "__RUNNER_NAME__"
+  url = "__GITLAB_URL__"
+  token = "__RUNNER_TOKEN__"
+  executor = "docker"
+  tag_list = "__RUNNER_TAGS__"
+  [runners.docker]
+    tls_verify = false
+    image = "docker:27"
+    privileged = true
+    disable_entrypoint_overwrite = false
+    oom_kill_disable = false
+    disable_cache = false
+    volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/etc/docker/daemon.json:/etc/docker/daemon.json", "__PROJECT_DIR__:__PROJECT_DIR__", "/cache"]
+    shm_size = 0
+    network_mtu = 0
+    pull_policy = ["if-not-present"]
+    helper_image = "gitlab/gitlab-runner-helper:__HELPER_VERSION__"

package/cli-template/deploy/gitlab-runner/docker-compose.yml

@@ -0,0 +1,39 @@
+name: {{project.name}}-runner
+
+services:
+  gitlab-runner:
+    image: gitlab/gitlab-runner:${GITLAB_VERSION}
+    hostname: ${RUNNER_NAME}
+    container_name: ${RUNNER_NAME}
+    environment:
+      - TZ=Europe/Moscow
+      - RUNNER_NAME=${RUNNER_NAME}
+      - RUNNER_TOKEN=${RUNNER_TOKEN}
+      - PROJECT_DIR=${PROJECT_DIR}
+      - GITLAB_URL=${GITLAB_URL}
+      - GITLAB_VERSION=${GITLAB_VERSION}
+      - RUNNER_TAGS=${RUNNER_TAGS}
+      - HELPER_VERSION=${HELPER_VERSION}
+    dns:
+      - 10.77.96.10
+      - 10.77.196.10
+    restart: always
+    entrypoint: ["/bin/sh", "/entrypoint.sh"]
+    volumes:
+      - './config:/etc/gitlab-runner'
+      - './entrypoint.sh:/entrypoint.sh:ro'
+      - '/var/run/docker.sock:/var/run/docker.sock'
+      - '/etc/docker/daemon.json:/etc/docker/daemon.json'
+    healthcheck:
+      test: ["CMD", "gitlab-runner", "status"]
+      interval: 1m
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+    networks:
+      - gitlab
+
+networks:
+  gitlab:
+    name: gitlab-network
+    driver: bridge

package/cli-template/deploy/gitlab-runner/entrypoint.sh

@@ -0,0 +1,27 @@
+#!/bin/sh
+set -e
+
+TEMPLATE="/etc/gitlab-runner/config.toml.template"
+CONFIG="/etc/gitlab-runner/config.toml"
+
+if [ -z "$RUNNER_TOKEN" ]; then
+  echo "ERROR: RUNNER_TOKEN is required" >&2
+  exit 1
+fi
+
+if [ -z "$PROJECT_DIR" ]; then
+  echo "ERROR: PROJECT_DIR is required" >&2
+  exit 1
+fi
+
+sed \
+  -e "s|__RUNNER_NAME__|${RUNNER_NAME}|g" \
+  -e "s|__RUNNER_TOKEN__|${RUNNER_TOKEN}|g" \
+  -e "s|__PROJECT_DIR__|${PROJECT_DIR}|g" \
+  -e "s|__RUNNER_TAGS__|${RUNNER_TAGS}|g" \
+  -e "s|__GITLAB_URL__|${GITLAB_URL}|g" \
+  -e "s|__GITLAB_VERSION__|${GITLAB_VERSION}|g" \
+  -e "s|__HELPER_VERSION__|${HELPER_VERSION}|g" \
+  "$TEMPLATE" > "$CONFIG"
+
+exec gitlab-runner run

package/cli-template/deploy/gitlab-runner/start.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+set -e
+cd "$(dirname "$0")"
+
+# Проверка наличия .env файла
+if [ ! -f .env ]; then
+    echo "ERROR: .env file not found in $(pwd)"
+    echo "Copy .env.example to .env and fill in the values:"
+    echo "  cp .env.example .env"
+    exit 1
+fi
+
+# Загружаем .env в текущий shell
+set -a
+. .env
+set +a
+
+# Проверка обязательных переменных
+required_vars=(
+    "GITLAB_URL"
+    "RUNNER_NAME"
+    "RUNNER_TOKEN"
+)
+missing=()
+for var in "${required_vars[@]}"; do
+    if [ -z "${!var}" ]; then
+        missing+=("$var")
+    fi
+done
+if [ ${#missing[@]} -gt 0 ]; then
+    echo "ERROR: Required variables not set in .env:"
+    for var in "${missing[@]}"; do
+        echo "  - $var"
+    done
+    exit 1
+fi
+
+# PROJECT_DIR: если не задан — два уровня вверх (корень проекта)
+if [ -z "$PROJECT_DIR" ]; then
+    PROJECT_DIR="../.."
+fi
+
+# Резолвим в абсолютный путь
+PROJECT_DIR=$(cd "$PROJECT_DIR" && pwd)
+export PROJECT_DIR
+
+exec docker compose up -d "$@"

package/cli-template/gitignore

@@ -1,95 +1,96 @@
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Build outputs
-dist/
-build/
-out/
-.next/
-.nuxt/
-.cache/
-
-# Environment variables
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-
-# Coverage directory used by tools like istanbul
-coverage/
-.nyc_output/
-
-# IDE / editors
-.idea/
-.vscode/
-*.swp
-*.swo
-.DS_Store
-*.sublime-project
-*.sublime-workspace
-
-# Misc
-Thumbs.db
-
-# Files formed by Realtime
-/_files/
-/_cache/
-/_data/
-
-# DEV directories
-.tmp/
-temp/
-/__misc/
-**/_tmp/
-**/_sand/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Keep example env file
-!.env.example
-
-# OS specific files
-.github
-
-# Private exceptions
-/config/local.*
-local-*.*
-/t.*
-*.local.*
-*.private.*
-**/ignor.*
-**/ignore.*
-**/*.ignore/**
-~$*.*
-*.rar
-
-# API response logs for testing
-_api_responses/
-_logs/
-/config.yaml
-/.claude/glm.ps1
-
-/_misc_/
-/deploy/config.yml
-/config/__server__/
-glm.ps1
-glm.sh
-/~last-cli-config.json
-/.npmrc
-/.serena/
-/.playwright-mcp/
-/claudedocs/
-preferred-language.txt
-/mcp-ext-apps/
-.agents/
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+.nuxt/
+.cache/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Coverage directory used by tools like istanbul
+coverage/
+.nyc_output/
+
+# IDE / editors
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+*.sublime-project
+*.sublime-workspace
+
+# Misc
+Thumbs.db
+
+# Files formed by Realtime
+/_files/
+/_cache/
+/_data/
+
+# DEV directories
+.tmp/
+temp/
+/__misc/
+**/_tmp/
+**/_sand/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Keep example env file
+!.env.example
+
+# OS specific files
+.github
+
+# Private exceptions
+/config/local.*
+local-*.*
+/t.*
+*.local.*
+*.private.*
+**/ignor.*
+**/ignore.*
+**/*.ignore/**
+~$*.*
+*.rar
+
+# API response logs for testing
+_api_responses/
+_logs/
+/config.yaml
+/.claude/glm.ps1
+
+/_misc_/
+/deploy/config.yml
+/config/__server__/
+glm.ps1
+glm.sh
+/~last-cli-config.json
+/.npmrc
+/.serena/
+/.playwright-mcp/
+/claudedocs/
+preferred-language.txt
+/mcp-ext-apps/
+.agents/
+.qwen/

package/cli-template/package.json

@@ -58,7 +58,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^17.4.1",
-    "fa-mcp-sdk": "^0.4.142"
+    "fa-mcp-sdk": "^0.11.2"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",