Skip to main content
Glama

PocketLantern

npm version npm downloads CI License: MIT

Ваш ИИ-агент звучит уверенно. Но он упустил блокирующие факторы.

Цены меняются, версии ломаются, лицензии обновляются. PocketLantern — это уровень принятия решений с учетом блокирующих факторов для ИИ-агентов, основанный на проверенных фактах со ссылками на источники.

Попробуйте эти запросы

Спросите своего ИИ-агента после установки PocketLantern:

«Какого провайдера аутентификации выбрать — Clerk, Auth0 или Cognito?»

⚠️ Cognito password hashes are permanently non-exportable
⚠️ Auth0 password export requires support ticket — Free tier excluded
⚠️ Auth0 Rules/Hooks EOL 2026-11-18 — Actions not portable
✅ Clerk has the most flexible migration path

«Стоит ли мне обновляться до Next.js 16?»

⚠️ Sync API access fully removed — all dynamic calls must be awaited
⚠️ Custom webpack config breaks next build
⚠️ next lint removed — switch to Biome or ESLint CLI
⚠️ Requires Node.js 20.9.0+, TypeScript 5.1.0+, React 19.0+
✅ Plan phased migration — codemod doesn't cover webpack or middleware

«Могу ли я использовать OpenAI Realtime API?»

⚠️ gpt-4o-realtime-preview removed 2026-05-07
⚠️ Beta interface (realtime=v1 header) removed same date
⚠️ GA event schema incompatible — 4 event renames
✅ Start on GA from day one — or plan dual-stack migration

Три вопроса. Три типа блокирующих факторов. Тот же ИИ, но другие факты.

Демонстрация PocketLantern — блокирующие факторы при обновлении Node.js с 20 до 24 версии отображаются за секунды

Related MCP server: @4da/mcp-server

Быстрый старт

Предварительные требования: Node.js >= 22, MCP-клиент (Claude Code, Cursor и др.)

npm install -g pocketlantern

Claude Code

В директории вашего проекта:

cd your-project
pocketlantern init

init регистрирует MCP-сервер в ~/.claude.json и добавляет правило в одну строку в файл CLAUDE.md вашего проекта. Перезапустите Claude Code (Ctrl+C, затем снова запустите claude), после чего задайте свой первый запрос.

Cursor / Windsurf / другие MCP-клиенты

Добавьте в свою конфигурацию MCP (Cursor: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "pocketlantern": {
      "command": "pocketlantern-mcp"
    }
  }
}

Затем добавьте эту строку в правила вашего проекта (.cursorrules, файл настроек Kiro и т. д.):

For technology decisions, upgrades, migrations, or licensing questions: before finalizing your answer, check the PocketLantern MCP server's search_cards tool for blockers in these bundled decision cards — your training data may be stale.

Перезагрузите MCP-серверы: Cursor — Cmd+Shift+P -> «MCP: Restart Servers». Windsurf — перезапустите редактор.

Другие запросы для проверки

  1. «Как изменилось ценообразование Vercel с появлением Fluid Compute?» Разделение биллинга на активный CPU + память, конкурентность общих процессов нарушает изоляцию

  2. «Prisma или Drizzle для Edge/serverless?» Prisma v7 ESM + адаптер драйвера вызывает поломки, Edge только в превью; Drizzle 0.30-1.0 также вызывает поломки

Проверка установки

pocketlantern doctor               # check installation status
pocketlantern search "auth pricing" # search cards from CLI

Как это работает

PocketLantern — это MCP-сервер. Ваш ИИ-агент вызывает search_cards — и получает карточки решений со ссылками на источники, а также предупреждения о блокирующих факторах, если они есть.

Agent asks question
  -> search_cards("clerk vs auth0 authentication")
  -> 3 cards + 5 blocker warnings (lock-in, EOL, export restrictions)
  -> Agent answers with source-linked constraints

Локальный набор карточек. Мгновенный поиск. Никаких векторных баз данных. Никаких эмбеддингов. Поиск по ключевым словам, ссылки на карточки и предупреждения о блокирующих факторах со ссылками на источники. Ценность заключается в карточках решений со ссылками на источники, а не только в умном поиске.

search_cards("auth", constraints:["serverless"]) -> cards + blockers
get_card("auth/clerk-vs-auth0-vs-cognito-2026")  -> full card with facts
get_related_cards(...)                           -> connected topics

Что включено

Карточки решений с учетом блокирующих факторов по 27 категориям — плюс предупреждения о блокирующих факторах со ссылками на источники из встроенного графового индекса. Поставляется с npm-пакетом, работает сразу, без сети, без учетной записи:

Категория

Что охватывает

auth

Привязка к вендору, сложности миграции, SSO, RBAC, passkeys

frontend

Блокирующие факторы при обновлении Next.js, React, Svelte, Vite, Angular

database

Prisma, Drizzle, Postgres, Aurora, Neon, Supabase

ai

Миграции OpenAI API, цены на модели, пакетная обработка против потоковой

serverless

Стоимость и среда выполнения Vercel, Cloudflare Workers, Lambda

infra

Платформы хостинга, Terraform, Node.js LTS, Python EOL

backend

Supabase против Firebase, Express, очереди задач, синхронизация в реальном времени

+ еще 18

развертывание, инструменты разработки, тестирование, безопасность, комплаенс, ...

Как выглядит карточка

Каждая карточка — это структурированный YAML-файл с фактами, подкрепленными ссылками на официальные источники:

id: auth/clerk-vs-auth0-vs-cognito-2026
title: Clerk vs Auth0 vs Cognito Under Current Pricing and Feature Changes
problem: Select an auth vendor given recent pricing shifts, MAU economics, ...
constraints: [cost-sensitive, low-ops, enterprise, compliance, serverless]
candidates:
  - name: Clerk
    summary: "Pro starts at $20/mo, includes 50,000 MRUs per app..."
    when_to_use: "Choose for small-team + low-ops + cost-sensitive SaaS..."
    tradeoffs: "Best DX and fastest implementation..."
    cautions: "Be precise about org-member limits..."
    links:
      - https://clerk.com/pricing
      - https://clerk.com/docs/guides/organizations/configure
  - name: Auth0
    # ...
  - name: Amazon Cognito
    # ...
tags: [auth, clerk, auth0, pricing, passkeys, b2b, compliance]
related_cards: [auth/sso-for-b2b-saas, auth/rbac-vs-abac-vs-rebac]
updated: 2026-03-14

См. packages/schema/src/card.ts для полного определения схемы.

Структура проекта

pocketlantern/
  packages/schema/       <- Card schema (zod + TypeScript types)
  apps/mcp-server/       <- MCP server (search, retrieval, tool handlers)
  apps/cli/              <- CLI (validate, search, init, doctor)
  packages/knowledge/    <- Decision cards + graph index (data package)
  docs/                  <- User guides & roadmap

Монорепозиторий: pnpm workspace. Порядок сборки: schema -> knowledge (без сборки) -> mcp-server -> cli.

Разработка

pnpm build              # Build all packages
pnpm test               # Run tests (299 tests)
pnpm test:coverage      # Run with coverage report
pnpm lint               # ESLint
pnpm format:check       # Prettier check

Не хватает темы? Запросите покрытие в Card Requests.

Участие в разработке

Приветствуется вклад в инструмент (схема, MCP-сервер, CLI, поиск). См. CONTRIBUTING.md для ознакомления с правилами.

Лицензия

MIT

Related MCP Connectors

Related MCP Servers