TraceFact MCP Server

Быстрый старт за 60 секунд

git clone https://github.com/Alex0AI/tracefact.git
cd tracefact
npm ci
npm run build
node dist/cli.js analyze examples/offline-demo.codex.jsonl --out report

Откройте report/report.html. Он автономен и работает офлайн. Команда также записывает report.json, report.md, report.sarif и капсулу воспроизведения run.tracefact.gz с проверкой хэша.

Предпочитаете браузер? Откройте живое демо, перетащите трассу и экспортируйте отчёт. Файл никогда не покидает страницу.

Related MCP server: jaeger-mcp

Что на входе; что на выходе; почему это заслуживает доверия

flowchart LR
  A[Codex / Gemini CLI / Browser Use / JSONL / OTel] --> B[Open Agent Trace Schema]
  B --> C[Redaction]
  C --> D[Evidence Graph]
  C --> E[Deterministic failure rules]
  D --> F[HTML · JSON · Markdown · SARIF]
  E --> F
  C --> G[Replay Capsule + SHA-256]

TraceFact не прячет корректность за одним показателем LLM-как-судьи. Он извлекает явные утверждения о завершении и связывает каждое из них с наблюдаемыми результатами инструментов, тестами, диффами, действиями браузера, источниками и хэшами артефактов. Каждое заключение о сбое содержит точные идентификаторы событий. Отсутствующая телеметрия отображается как неопределённость.

Исходное ядро

• Open Agent Trace Schema (OATS) 1.0 — версионируемая, расширяемая оболочка трасс с JSON Schema, строгими типами TypeScript и миграциями.

• Граф доказательств — утверждения supported, weak, unsupported или conflicting с причинно-следственными рёбрами доказательств и пояснениями.

• Капсула воспроизведения — переносимый, редактируемый, сжатый gzip запуск, содержащий нормализованную трассу, сводку окружения, метаданные источников, отчёт и хэши. Для проверки не требуются исходная модель или API-ключ.

• Таксономия сбоев — детерминированная локализация циклов, повторных вызовов, дрейфа поиска, непроверенных изменений, проваленных тестов, завершения без доказательств, скачков стоимости, преждевременного завершения и неудачного восстановления.

• Отчёт о надёжности — автономный HTML плюс JSON, Markdown и SARIF. Оценки бенчмарков остаются в рамках своего исходного бенчмарка.

Адаптеры

Адаптеры — это плагины. Реализуйте небольшой интерфейс TraceAdapter, экспортируемый из tracefact/adapter-sdk; неизвестные поля сохраняются в attributes или extensions.

CLI

tracefact analyze <trace> [--adapter auto] [--out tracefact-report]
tracefact replay <run.tracefact.gz> [--out replay.html]
tracefact verify <run.tracefact.gz>
tracefact migrate <old-trace.json> --out migrated.json
tracefact adapters
tracefact serve --dir web-dist --port 4173

GitHub Action

- uses: Alex0AI/tracefact/action@v0.1.2
  with:
    trace: artifacts/codex-rollout.jsonl
    adapter: auto

Действие добавляет сводку задания, обновляет комментарий PR на основе маркеров, когда предоставлено право pull-requests: write, и загружает полный пакет HTML/JSON/Markdown/SARIF/капсула. Никакая трасса не отправляется третьим лицам.

MCP-сервер только для чтения

{
  "mcpServers": {
    "tracefact": {
      "command": "node",
      "args": ["/absolute/path/to/tracefact/dist/mcp.js"],
      "env": { "TRACEFACT_STORE": "/absolute/path/to/traces" }
    }
  }
}

Инструменты: list_runs, get_run и get_reliability_report. Инструментов записи нет.

Небольшой воспроизводимый набор доказательств

dataset/generated/ содержит 60 детерминированных синтетических трасс CC0-1.0, охватывающих успех, проваленные тесты, циклы инструментов, неподтверждённое завершение, аномалии стоимости и успешное восстановление. Перегенерируйте с помощью npm run dataset:generate; оцените с помощью npm run experiment.

Эксперимент v0.1 сообщает о микро-точности 0.833, полноте 1.000 и F1 0.909 на синтетических метках, созданных по правилам. Все 10 очевидных ложных срабатываний — это находки hallucinated_completion на фикстурах, чья основная метка — test_failure: утверждение о завершении конфликтует с проваленным тестом, но эта вторичная метка была намеренно опущена. Это раскрывает многометочную неоднозначность, а не скрывает её. Результат — регрессионное доказательство, а не подтверждение обобщения в реальном мире. См. карточку данных, сырые результаты и технический отчёт.

Где вписывается TraceFact

Это сравнение по охвату на основе публичной документации, проверено 2026-08-20 — не рейтинг качества. TraceFact может принимать OpenTelemetry, экспортируемый существующими стеками наблюдаемости, вместо их замены.

Конфиденциальность и безопасность

Редактирование охватывает распространённые API-ключи, bearer-токены, cookie, электронные письма, домашние пути Windows/macOS/Linux и поля, названные как секреты. Относитесь к редактированию как к защите в глубину: проверяйте капсулу перед публикацией. TraceFact по умолчанию работает с данными публичных репозиториев, не имеет телеметрии и никогда не загружает трассу.

Разработка

npm ci
npm run check
npm run test:coverage

CI работает на Windows, Linux и macOS с Node 20 и 22. См. CONTRIBUTING.md, SECURITY.md и DECISIONS.md.

Лицензия

Apache-2.0. Она разрешительна для коммерческого и исследовательского использования, включает явный патентный грант и требует сохранения уведомлений. Фикстуры набора данных — CC0-1.0. Внешние проекты и данные остаются под собственными лицензиями; см. THIRD_PARTY.md и DATA_SOURCES.md.