@oneentry/mcp-platform-server 0.1.1 → 0.1.4

package/dist/index.js

@@ -1,7 +1,3 @@
-/**
- * Публичный API пакета: всё, что нужно, чтобы встроить сервер в свой процесс
- * или собрать его иначе, чем это делает CLI.
- */
 export { loadConfig, parseFlags, normalizeBaseUrl, ConfigSchema } from './config/config.js';
 export { createServer, createSharedDeps } from './server.js';
 export { Session } from './session.js';
@@ -16,7 +12,6 @@ export { packFromFiles, resolveKnowledge, seedPack } from './knowledge/loader.js
 export { fetchKnowledgeTree, readLocalTree } from './knowledge/github.js';
 export { readTar, readTarGz } from './knowledge/tar.js';
 export { buildCatalog } from './api/build-catalog.js';
-export { fetchSwagger } from './api/swagger-source.js';
+export { fetchSwagger, nestSwaggerUrl, nodeSwaggerUrl, swaggerAttempts } from './api/swagger-source.js';
 export { runStdio } from './transports/stdio.js';
 export { runHttp } from './transports/http.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/knowledge/chunk.d.ts

@@ -1,27 +1,13 @@
 import type { KnowledgeChunk, KnowledgeDoc } from './types.js';
-/**
- * Слаг заголовка в стиле GitHub: нижний регистр, пробелы в дефисы,
- * пунктуация выброшена. Кириллица сохраняется — документация в проекте русскоязычная.
- */
 export declare const slugify: (heading: string) => string;
 interface Section {
     title: string;
     lines: string[];
 }
-/**
- * Режет markdown по заголовкам `##` и `###`.
- * Преамбула до первого `##` становится разделом с пустым anchor — в ней обычно
- * лежит самое важное описание модуля, терять его нельзя.
- */
 export declare const splitSections: (markdown: string) => {
     docTitle: string;
     sections: Section[];
 };
-/**
- * Превращает один markdown-файл в документ + его разделы.
- * Anchor'ы дедуплицируются суффиксом, иначе два одинаковых `## Схема`
- * в одном файле стали бы неразличимы для cms_docs_read.
- */
 export declare const chunkDocument: (params: {
     docId: string;
     repo: KnowledgeChunk["repo"];
@@ -32,4 +18,3 @@ export declare const chunkDocument: (params: {
     chunks: KnowledgeChunk[];
 };
 export {};
-//# sourceMappingURL=chunk.d.ts.map

package/dist/knowledge/chunk.js

@@ -1,20 +1,10 @@
-/**
- * Слаг заголовка в стиле GitHub: нижний регистр, пробелы в дефисы,
- * пунктуация выброшена. Кириллица сохраняется — документация в проекте русскоязычная.
- */
 export const slugify = (heading) => heading
     .toLowerCase()
     .replace(/`|\*|_|\[|\]|\(|\)|:|,|\.|\/|\\|«|»|"|'|\?|!|;/g, '')
     .trim()
     .replace(/\s+/g, '-')
     .slice(0, 80);
-/** Строки внутри огороженных блоков кода не считаются заголовками. */
 const isFence = (line) => line.startsWith('```') || line.startsWith('~~~');
-/**
- * Режет markdown по заголовкам `##` и `###`.
- * Преамбула до первого `##` становится разделом с пустым anchor — в ней обычно
- * лежит самое важное описание модуля, терять его нельзя.
- */
 export const splitSections = (markdown) => {
     const lines = markdown.split('\n');
     let docTitle = '';
@@ -43,11 +33,6 @@ export const splitSections = (markdown) => {
         sections: sections.filter((s) => s.title !== '' || s.lines.join('').trim() !== ''),
     };
 };
-/**
- * Превращает один markdown-файл в документ + его разделы.
- * Anchor'ы дедуплицируются суффиксом, иначе два одинаковых `## Схема`
- * в одном файле стали бы неразличимы для cms_docs_read.
- */
 export const chunkDocument = (params) => {
     const { docTitle, sections } = splitSections(params.markdown);
     const seen = new Map();
@@ -84,4 +69,3 @@ export const chunkDocument = (params) => {
         chunks,
     };
 };
-//# sourceMappingURL=chunk.js.map

package/dist/knowledge/github.d.ts

@@ -1,46 +1,21 @@
-/** Откуда и как забирать репозиторий знаний. */
 export interface KnowledgeSource {
-    /** `owner/name` публичного репозитория GitHub. */
     repo: string;
-    /** Ветка, тег или sha. */
     ref: string;
     cacheDir: string;
-    /** Как долго считать закэшированный sha свежим, не спрашивая GitHub. */
     refreshTtlMs: number;
-    /** Не ходить в сеть вовсе: только кэш. */
     offline: boolean;
-    /** Токен GitHub — только чтобы поднять лимит API; репозиторий публичный. */
     token?: string;
     timeoutMs: number;
 }
-/** Файл документации, вынутый из репозитория. */
 export interface KnowledgeFile {
-    /** Путь относительно каталога `knowledge/`, например `back/docs/menus-module.md`. */
     path: string;
     content: string;
 }
-/** Результат получения дерева знаний. */
 export interface KnowledgeTree {
     files: KnowledgeFile[];
     sha: string;
-    /** `github` — только что скачано, `cache` — взято с диска. */
     source: 'github' | 'cache';
 }
-/** Рекурсивно собирает `*.md` каталога. Используется и кэшем, и локальным клоном. */
 export declare const walkMarkdown: (root: string) => string[];
-/**
- * Отдаёт дерево знаний, предпочитая кэш.
- * Порядок такой: свежий кэш -> сверка sha -> скачивание. Пока запись кэша моложе
- * `refreshTtlMs`, сеть не трогается вообще — иначе цикл перезапусков сервера
- * упирался бы в лимит анонимного API GitHub.
- * Бросает исключение, если знания взять неоткуда; решение о запасном варианте
- * принимает вызывающий.
- */
 export declare const fetchKnowledgeTree: (source: KnowledgeSource) => Promise<KnowledgeTree>;
-/**
- * Читает знания из локального клона репозитория.
- * Принимает и корень клона, и сам каталог `knowledge/` — путать их слишком легко,
- * а разница видна по наличию подкаталога.
- */
 export declare const readLocalTree: (path: string) => KnowledgeFile[];
-//# sourceMappingURL=github.d.ts.map

package/dist/knowledge/github.js

@@ -1,10 +1,8 @@
 import { mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { dirname, join, relative, resolve, sep } from 'node:path';
 import { readTarGz } from './tar.js';
-/** Каталог внутри репозитория, в котором лежит документация. */
 const ROOT = 'knowledge';
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-/** Каталог кэша одного репозитория. Слэш в имени заменён, чтобы это был один уровень. */
 const repoCacheDir = (source) => resolve(source.cacheDir, source.repo.replace('/', '--'));
 const stateFile = (source) => join(repoCacheDir(source), 'current.json');
 const readState = (source) => {
@@ -26,7 +24,6 @@ const writeState = (source, state) => {
     mkdirSync(repoCacheDir(source), { recursive: true });
     writeFileSync(stateFile(source), `${JSON.stringify(state)}\n`);
 };
-/** Рекурсивно собирает `*.md` каталога. Используется и кэшем, и локальным клоном. */
 export const walkMarkdown = (root) => {
     const out = [];
     const visit = (dir) => {
@@ -52,7 +49,6 @@ const exists = (path) => {
         return false;
     }
 };
-/** Читает распакованное дерево из кэша. */
 const readCached = (source, sha) => {
     const dir = join(repoCacheDir(source), sha, ROOT);
     if (!exists(dir)) {
@@ -63,11 +59,6 @@ const readCached = (source, sha) => {
         content: readFileSync(file, 'utf8'),
     }));
 };
-/**
- * Записывает дерево в кэш и удаляет каталоги остальных sha.
- * Кэш адресуется коммитом, поэтому старые версии не нужны никогда:
- * запись неизменяема, и «протухнуть» она не может.
- */
 const writeCache = (source, sha, files) => {
     const base = repoCacheDir(source);
     const target = join(base, sha, ROOT);
@@ -87,11 +78,6 @@ const headers = (source, accept) => ({
     'user-agent': 'oneentry-mcp-platform',
     ...(source.token ? { authorization: `Bearer ${source.token}` } : {}),
 });
-/**
- * Расшифровывает код ответа GitHub в причину, по которой ref не превратился в коммит.
- * Голый статус здесь бесполезен: 404 и 409 — это разные ошибки настройки, и обе
- * встречаются при первом подключении к новому репозиторию знаний.
- */
 const shaFailureHint = (status) => {
     switch (status) {
         case 403: {
@@ -108,10 +94,6 @@ const shaFailureHint = (status) => {
         }
     }
 };
-/**
- * Превращает ref в конкретный коммит. Ответ — голый sha, поэтому запрос дешёвый:
- * его можно делать при каждом запуске, не скачивая архив.
- */
 const resolveSha = async (source) => {
     const url = `https://api.github.com/repos/${source.repo}/commits/${encodeURIComponent(source.ref)}`;
     const response = await fetch(url, {
@@ -128,11 +110,6 @@ const resolveSha = async (source) => {
     }
     return sha;
 };
-/**
- * Отбирает из архива только документацию.
- * Всё, что вне `knowledge/`, и любой путь с `..` отбрасываются: архив приходит
- * из сети, и он не должен решать, куда мы пишем.
- */
 const selectDocs = (entries) => {
     const prefix = `${ROOT}/`;
     return entries
@@ -141,7 +118,6 @@ const selectDocs = (entries) => {
         !entry.path.split('/').includes('..'))
         .map((entry) => ({ path: entry.path.slice(prefix.length), content: entry.content }));
 };
-/** Скачивает архив репозитория на конкретном коммите. Один запрос, лимитов API нет. */
 const download = async (source, sha) => {
     const url = `https://codeload.github.com/${source.repo}/tar.gz/${sha}`;
     const response = await fetch(url, {
@@ -157,18 +133,9 @@ const download = async (source, sha) => {
     }
     return files;
 };
-/**
- * Отдаёт дерево знаний, предпочитая кэш.
- * Порядок такой: свежий кэш -> сверка sha -> скачивание. Пока запись кэша моложе
- * `refreshTtlMs`, сеть не трогается вообще — иначе цикл перезапусков сервера
- * упирался бы в лимит анонимного API GitHub.
- * Бросает исключение, если знания взять неоткуда; решение о запасном варианте
- * принимает вызывающий.
- */
 export const fetchKnowledgeTree = async (source) => {
     const state = readState(source);
     const files = state && state.ref === source.ref ? readCached(source, state.sha) : undefined;
-    /** Кэш годен только целиком: и запись о коммите, и распакованное дерево. */
     const cache = state && files ? { state, files } : undefined;
     if (cache && (source.offline || Date.now() - cache.state.checkedAt < source.refreshTtlMs)) {
         return { files: cache.files, sha: cache.state.sha, source: 'cache' };
@@ -182,7 +149,6 @@ export const fetchKnowledgeTree = async (source) => {
     }
     catch (error) {
         if (cache) {
-            /** Сеть недоступна, но кэш есть — работаем на нём, это не отказ. */
             return { files: cache.files, sha: cache.state.sha, source: 'cache' };
         }
         throw error;
@@ -196,11 +162,6 @@ export const fetchKnowledgeTree = async (source) => {
     writeState(source, { ref: source.ref, sha, checkedAt: Date.now() });
     return { files: downloaded, sha, source: 'github' };
 };
-/**
- * Читает знания из локального клона репозитория.
- * Принимает и корень клона, и сам каталог `knowledge/` — путать их слишком легко,
- * а разница видна по наличию подкаталога.
- */
 export const readLocalTree = (path) => {
     const root = exists(join(path, ROOT)) ? join(path, ROOT) : path;
     if (!exists(root)) {
@@ -211,4 +172,3 @@ export const readLocalTree = (path) => {
         content: readFileSync(file, 'utf8'),
     }));
 };
-//# sourceMappingURL=github.js.map

package/dist/knowledge/loader.d.ts

@@ -1,10 +1,8 @@
 import { type KnowledgeFile } from './github.js';
 import type { KnowledgeOrigin, KnowledgePack } from './types.js';
-/** Настройки источника знаний, как их отдаёт конфигурация. */
 export interface KnowledgeConfig {
     repo: string;
     ref: string;
-    /** Локальный клон репозитория знаний: приоритетнее сети. */
     path?: string;
     cacheDir: string;
     refreshTtlMs: number;
@@ -12,22 +10,9 @@ export interface KnowledgeConfig {
     token?: string;
     timeoutMs: number;
 }
-/** Каталог с вшитым минимумом знаний (`operating-rules.md`). */
 export declare const seedDir: () => string;
-/** Каталог со сгенерированными данными пакета (`permissions.json`). */
 export declare const dataDir: () => string;
-/**
- * docId из пути внутри `knowledge/`.
- * `<имя>/index.md` даёт docId `<имя>`: это позволяет разрезать большой документ
- * на каталог из мелких файлов, не меняя идентификатор, на который уже ссылаются
- * `docLinks` каталога операций и золотые запросы тестов.
- */
 export declare const docIdFromPath: (path: string) => string;
-/**
- * Собирает пакет знаний из плоского списка файлов.
- * Один вход для всех трёх источников — сети, кэша и локального клона, — поэтому
- * поведение поиска не может разойтись между ними.
- */
 export declare const packFromFiles: (params: {
     files: readonly KnowledgeFile[];
     source: KnowledgeOrigin;
@@ -37,18 +22,5 @@ export declare const packFromFiles: (params: {
     sha?: string;
     warning?: string;
 }) => KnowledgePack;
-/**
- * Вшитый минимум: собственные правила эксплуатации пакета.
- * Существует только затем, чтобы сервер без сети всё равно мог ответить на вопрос
- * «как безопасно писать в эту CMS». Всё остальное живёт в репозитории знаний.
- */
 export declare const seedPack: (warning?: string) => KnowledgePack;
-/**
- * Выбирает источник знаний: локальный клон -> GitHub (через кэш) -> вшитый минимум.
- * Недоступный GitHub не мешает серверу подняться: пакет беднеет до вшитого минимума,
- * а причина уезжает в `warning`, потому что сеть — не ошибка конфигурации.
- * Единственное исключение бросается на нечитаемый локальный путь: его оператор указал
- * явно, и молчаливое падение до вшитых правил выглядело бы как пустой корпус.
- */
 export declare const resolveKnowledge: (config: KnowledgeConfig) => Promise<KnowledgePack>;
-//# sourceMappingURL=loader.d.ts.map

package/dist/knowledge/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/knowledge/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EAAgC,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,gEAAgE;AAChE,eAAO,MAAM,OAAO,QAAO,MAC+C,CAAC;AAE3E,uEAAuE;AACvE,eAAO,MAAM,OAAO,QAAO,MAC0C,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MACM,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ;IACpC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,aA2BH,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,aAWxC,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,eAAe,KAAG,OAAO,CAAC,aAAa,CA2CrF,CAAC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/knowledge/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,YAAY,CAAC;AAsF9E,2EAA2E;AAC3E,eAAO,MAAM,eAAe,QAAO,MACuC,CAAC;AAE3E,2EAA2E;AAC3E,eAAO,MAAM,OAAO,QAAO,MAC0C,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB,KAAG,aA0BH,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,YAAY,QAAO,aAO/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,aAUH,CAAC"}

package/dist/knowledge/loader.js

@@ -4,22 +4,9 @@ import { fileURLToPath } from 'node:url';
 import { chunkDocument } from './chunk.js';
 import { fetchKnowledgeTree, readLocalTree } from './github.js';
 const messageOf = (error) => error instanceof Error ? error.message : String(error);
-/** Каталог с вшитым минимумом знаний (`operating-rules.md`). */
 export const seedDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../knowledge');
-/** Каталог со сгенерированными данными пакета (`permissions.json`). */
 export const dataDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../data');
-/**
- * docId из пути внутри `knowledge/`.
- * `<имя>/index.md` даёт docId `<имя>`: это позволяет разрезать большой документ
- * на каталог из мелких файлов, не меняя идентификатор, на который уже ссылаются
- * `docLinks` каталога операций и золотые запросы тестов.
- */
 export const docIdFromPath = (path) => path.replace(/\.md$/, '').replace(/\/index$/, '');
-/**
- * Собирает пакет знаний из плоского списка файлов.
- * Один вход для всех трёх источников — сети, кэша и локального клона, — поэтому
- * поведение поиска не может разойтись между ними.
- */
 export const packFromFiles = (params) => {
     const docs = [];
     const chunks = [];
@@ -46,11 +33,6 @@ export const packFromFiles = (params) => {
         chunks,
     };
 };
-/**
- * Вшитый минимум: собственные правила эксплуатации пакета.
- * Существует только затем, чтобы сервер без сети всё равно мог ответить на вопрос
- * «как безопасно писать в эту CMS». Всё остальное живёт в репозитории знаний.
- */
 export const seedPack = (warning) => packFromFiles({
     files: [
         {
@@ -62,13 +44,6 @@ export const seedPack = (warning) => packFromFiles({
     builtAt: new Date().toISOString(),
     ...(warning ? { warning } : {}),
 });
-/**
- * Выбирает источник знаний: локальный клон -> GitHub (через кэш) -> вшитый минимум.
- * Недоступный GitHub не мешает серверу подняться: пакет беднеет до вшитого минимума,
- * а причина уезжает в `warning`, потому что сеть — не ошибка конфигурации.
- * Единственное исключение бросается на нечитаемый локальный путь: его оператор указал
- * явно, и молчаливое падение до вшитых правил выглядело бы как пустой корпус.
- */
 export const resolveKnowledge = async (config) => {
     const builtAt = new Date().toISOString();
     if (config.path) {
@@ -109,4 +84,3 @@ export const resolveKnowledge = async (config) => {
             'Only the bundled operating rules are available — module reference docs will not be found.');
     }
 };
-//# sourceMappingURL=loader.js.map

package/dist/knowledge/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/knowledge/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAgBpF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAC3C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,gEAAgE;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,GAAW,EAAE,CAClC,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAE3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,OAAO,GAAG,GAAW,EAAE,CAClC,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CACpD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAQ7B,EAAiB,EAAE;IAClB,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,aAAa,CAAC;YAC3B,KAAK;YACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK;YAClC,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,EAAE;YAC9B,QAAQ,EAAE,IAAI,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAiB,EAAE,CAC1D,aAAa,CAAC;IACZ,KAAK,EAAE;QACL;YACE,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;SACxE;KACF;IACD,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACjC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAChC,CAAC,CAAC;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAAuB,EAA0B,EAAE;IACxF,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,OAAO,aAAa,CAAC;gBACnB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;gBACjC,MAAM,EAAE,OAAO;gBACf,OAAO;gBACP,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,CAAC,IAAI,wBAAwB,SAAS,CAAC,KAAK,CAAC,KAAK;gBAC/E,yEAAyE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC;YACpC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,OAAO,aAAa,CAAC;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,QAAQ,CACb,wBAAwB,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,oBAAoB,SAAS,CAAC,KAAK,CAAC,KAAK;YACxF,2FAA2F,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/knowledge/loader.ts"],"names":[],"mappings":"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"}

package/dist/knowledge/search.d.ts

@@ -1,5 +1,4 @@
 import type { KnowledgeChunk, KnowledgeDoc, KnowledgePack } from './types.js';
-/** Найденный раздел с оценкой и вырезкой вокруг совпадения. */
 export interface KnowledgeHit {
     id: string;
     docId: string;
@@ -10,36 +9,15 @@ export interface KnowledgeHit {
     score: number;
     snippet: string;
 }
-/**
- * Выбрасывает из запроса слова короче трёх букв.
- * Заголовок весит вчетверо больше текста, поэтому раздел «Не входит в scope»
- * выигрывал у описания модуля на вопросе «почему атрибут не попал в индекс»:
- * два служебных слова совпадали с заголовком, а значащие — с телом. Предлоги и
- * частицы (`не`, `в`, `на`, `of`, `to`) не несут смысла ни в русском запросе,
- * ни в английском, и участвовать в ранжировании не должны.
- * Если после отбора не осталось ничего, запрос возвращается как есть —
- * поиск по одному короткому слову лучше поиска ни по чему.
- */
 export declare const meaningfulQuery: (query: string) => string;
-/**
- * Поисковый индекс по разделам документации.
- * Хранит только идентификаторы в индексе, а тексты — в отдельной карте:
- * так `cms_docs_search` отдаёт вырезки, не поднимая в память дубли корпуса.
- */
 export declare class KnowledgeIndex {
     private readonly mini;
     private readonly byId;
     private readonly byDocId;
     readonly pack: KnowledgePack;
     constructor(pack: KnowledgePack);
-    /** Разделы документа в порядке следования — для листания в cms_docs_read. */
     doc(docId: string): KnowledgeDoc | undefined;
     chunk(id: string): KnowledgeChunk | undefined;
     docs(): readonly KnowledgeDoc[];
-    /**
-     * Ищет разделы по запросу. Оценка minisearch домножается на веса источника и вида
-     * документа, поэтому правила эксплуатации всегда всплывают выше истории фиксов.
-     */
     search(query: string, limit?: number): KnowledgeHit[];
 }
-//# sourceMappingURL=search.d.ts.map

package/dist/knowledge/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAiCD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAG/C,CAAC;AAqBF;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa;IAkB/B,6EAA6E;IAC7E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI5C,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,IAAI,IAAI,SAAS,YAAY,EAAE;IAI/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE;CAwBjD"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAiCD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa;IAkB/B,6EAA6E;IAC7E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI5C,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,IAAI,IAAI,SAAS,YAAY,EAAE;IAI/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE;CAwBjD"}

package/dist/knowledge/search.js

@@ -1,9 +1,4 @@
 import MiniSearch from 'minisearch';
-/**
- * Веса источников. `mcp` — собственные правила эксплуатации, они всегда должны
- * побеждать первичную документацию; `fixes` — история багов, полезна, но шумна,
- * поэтому опускается вниз, чтобы не вытеснять описание модуля.
- */
 const REPO_WEIGHT = { mcp: 1.6, back: 1, front: 0.9 };
 const KIND_WEIGHT = {
     docs: 1.15,
@@ -12,13 +7,6 @@ const KIND_WEIGHT = {
     fixes: 0.6,
     specs: 0.6,
 };
-/**
- * Вид документа. Обычно это второй сегмент docId (`back/docs/…` -> `docs`),
- * но каталог `specs` третьим сегментом разбирается отдельно: это датированные
- * описания задач и merge request'ов. По форме документация, по сути — та же история изменений,
- * что и `fixes`: длинная прозаическая, богатая случайными совпадениями и
- * вытесняющая описание модуля. Вес у них поэтому такой же.
- */
 const kindOf = (docId) => {
     const parts = docId.split('/');
     if (parts[2] === 'specs') {
@@ -27,21 +15,10 @@ const kindOf = (docId) => {
     return parts[1] ?? 'docs';
 };
 const SNIPPET_RADIUS = 180;
-/**
- * Выбрасывает из запроса слова короче трёх букв.
- * Заголовок весит вчетверо больше текста, поэтому раздел «Не входит в scope»
- * выигрывал у описания модуля на вопросе «почему атрибут не попал в индекс»:
- * два служебных слова совпадали с заголовком, а значащие — с телом. Предлоги и
- * частицы (`не`, `в`, `на`, `of`, `to`) не несут смысла ни в русском запросе,
- * ни в английском, и участвовать в ранжировании не должны.
- * Если после отбора не осталось ничего, запрос возвращается как есть —
- * поиск по одному короткому слову лучше поиска ни по чему.
- */
 export const meaningfulQuery = (query) => {
     const kept = query.split(/\s+/).filter((word) => word.replace(/[^\p{L}\p{N}]/gu, '').length > 2);
     return kept.length > 0 ? kept.join(' ') : query;
 };
-/** Вырезка вокруг первого совпавшего терма; при отсутствии — начало раздела. */
 const makeSnippet = (text, terms) => {
     const flat = text.replace(/\s+/g, ' ').trim();
     const lower = flat.toLowerCase();
@@ -59,11 +36,6 @@ const makeSnippet = (text, terms) => {
     const end = Math.min(flat.length, at + SNIPPET_RADIUS);
     return `${start > 0 ? '…' : ''}${flat.slice(start, end)}${end < flat.length ? '…' : ''}`;
 };
-/**
- * Поисковый индекс по разделам документации.
- * Хранит только идентификаторы в индексе, а тексты — в отдельной карте:
- * так `cms_docs_search` отдаёт вырезки, не поднимая в память дубли корпуса.
- */
 export class KnowledgeIndex {
     mini;
     byId;
@@ -86,7 +58,6 @@ export class KnowledgeIndex {
         });
         this.mini.addAll(pack.chunks);
     }
-    /** Разделы документа в порядке следования — для листания в cms_docs_read. */
     doc(docId) {
         return this.byDocId.get(docId);
     }
@@ -96,10 +67,6 @@ export class KnowledgeIndex {
     docs() {
         return this.pack.docs;
     }
-    /**
-     * Ищет разделы по запросу. Оценка minisearch домножается на веса источника и вида
-     * документа, поэтому правила эксплуатации всегда всплывают выше истории фиксов.
-     */
     search(query, limit = 8) {
         const terms = query.split(/\s+/).filter((t) => t.length > 1);
         const raw = this.mini.search(meaningfulQuery(query));
@@ -125,4 +92,3 @@ export class KnowledgeIndex {
         return hits.slice(0, limit);
     }
 }
-//# sourceMappingURL=search.js.map

package/dist/knowledge/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"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"}

package/dist/knowledge/tar.d.ts

@@ -1,22 +1,7 @@
-/** Один распакованный файл архива. */
 export interface TarEntry {
-    /** Путь внутри архива, уже без корневого каталога. */
     path: string;
     content: string;
 }
-/**
- * Разбирает несжатый tar и возвращает только обычные файлы.
- * Своя реализация вместо зависимости: пакету нужен один сценарий чтения,
- * а каждая зависимость опубликованного npm-пакета — это ещё одна поверхность атаки.
- * Поддержаны оба способа записать длинный путь: расширенный заголовок pax
- * (`git archive`, а значит и GitHub) и GNU longname.
- */
 export declare const readTar: (buffer: Buffer) => TarEntry[];
-/**
- * Убирает общий первый сегмент пути. GitHub кладёт весь архив в каталог
- * `<repo>-<sha>/`, и без этого docId у каждого документа начинался бы с хэша коммита.
- */
 export declare const stripRoot: (entries: readonly TarEntry[]) => TarEntry[];
-/** Распаковывает `.tar.gz` целиком: gzip снимается встроенным zlib. */
 export declare const readTarGz: (buffer: Buffer) => TarEntry[];
-//# sourceMappingURL=tar.d.ts.map