@oneentry/mcp-platform-server 0.1.0 → 0.1.3

package/dist/api/shape.d.ts

@@ -1,19 +1,6 @@
-/** Результат подготовки ответа к отдаче модели. */
 export interface ShapedResponse {
     body: unknown;
     truncated: boolean;
 }
-/**
- * Приводит ответ Admin API к размеру, пригодному для контекста модели.
- * Массивы урезаются по элементам (а не обрывом JSON), поэтому результат
- * остаётся валидным и самоописанным: агент видит `_truncated` и сужает запрос.
- */
 export declare const shapeResponse: (raw: unknown, maxBytes: number) => ShapedResponse;
-/**
- * Сжимает текущее состояние цели до размера, который не топит ответ dry-run.
- * Целиком отдаётся только небольшая цель: для создания в коллекции «цель» — это весь
- * список существующих объектов, а он бывает в сотни килобайт и вытесняет собой
- * единственно нужные части плана — политику и собранный запрос.
- */
 export declare const summarizeTarget: (target: unknown) => unknown;
-//# sourceMappingURL=shape.d.ts.map

package/dist/api/shape.js

@@ -1,12 +1,9 @@
-/** Поля, значения которых бесполезны модели и раздувают ответ. */
 const BLOB_KEYS = new Set(['base64', 'buffer', 'content', 'fileContent', 'data64', 'blob']);
 const BLOB_VALUE_LIMIT = 512;
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-/** Похоже ли строковое значение на base64-блоб, который незачем показывать. */
 const looksLikeBlob = (key, value) => typeof value === 'string' &&
     value.length > BLOB_VALUE_LIMIT &&
     (BLOB_KEYS.has(key) || /^data:|^[A-Za-z0-9+/=]{512,}$/.test(value));
-/** Рекурсивно заменяет блобы заглушкой с указанием исходного размера. */
 const stripBlobs = (value, key = '') => {
     if (looksLikeBlob(key, value)) {
         return `[stripped ${String(value.length)} chars]`;
@@ -23,18 +20,12 @@ const stripBlobs = (value, key = '') => {
     }
     return value;
 };
-/**
- * Приводит ответ Admin API к размеру, пригодному для контекста модели.
- * Массивы урезаются по элементам (а не обрывом JSON), поэтому результат
- * остаётся валидным и самоописанным: агент видит `_truncated` и сужает запрос.
- */
 export const shapeResponse = (raw, maxBytes) => {
     const cleaned = stripBlobs(raw);
     const size = (value) => Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');
     if (size(cleaned) <= maxBytes) {
         return { body: cleaned, truncated: false };
     }
-    /** Массив верхнего уровня: оставляем префикс элементов. */
     if (Array.isArray(cleaned)) {
         const kept = takePrefix(cleaned, maxBytes);
         return {
@@ -49,7 +40,6 @@ export const shapeResponse = (raw, maxBytes) => {
             truncated: true,
         };
     }
-    /** Пагинированный объект: урезаем самый большой массив внутри него. */
     if (isRecord(cleaned)) {
         const arrayKey = Object.entries(cleaned)
             .filter(([, value]) => Array.isArray(value))
@@ -83,11 +73,8 @@ export const shapeResponse = (raw, maxBytes) => {
         truncated: true,
     };
 };
-/** Бюджет на показ текущего состояния цели в плане dry-run и в запросе подтверждения. */
 const TARGET_LIMIT = 4_000;
-/** Сколько идентификаторов списка показывать в сводке. */
 const TARGET_ID_SAMPLE = 20;
-/** Собирает опознавательные значения элементов списка: id, если он есть, иначе сам элемент. */
 const identify = (items) => items.slice(0, TARGET_ID_SAMPLE).map((item) => {
     if (!isRecord(item)) {
         return item;
@@ -95,12 +82,6 @@ const identify = (items) => items.slice(0, TARGET_ID_SAMPLE).map((item) => {
     const id = item['id'] ?? item['identifier'] ?? item['marker'];
     return id ?? Object.keys(item).slice(0, 3);
 });
-/**
- * Сжимает текущее состояние цели до размера, который не топит ответ dry-run.
- * Целиком отдаётся только небольшая цель: для создания в коллекции «цель» — это весь
- * список существующих объектов, а он бывает в сотни килобайт и вытесняет собой
- * единственно нужные части плана — политику и собранный запрос.
- */
 export const summarizeTarget = (target) => {
     if (target === undefined || target === null) {
         return null;
@@ -134,7 +115,6 @@ export const summarizeTarget = (target) => {
     }
     return { _summary: { kind: 'value', preview: String(target).slice(0, 200), hint } };
 };
-/** Берёт максимальный префикс массива, укладывающийся в бюджет байтов. */
 const takePrefix = (items, maxBytes) => {
     const kept = [];
     let used = 2;
@@ -148,4 +128,3 @@ const takePrefix = (items, maxBytes) => {
     }
     return kept;
 };
-//# sourceMappingURL=shape.js.map

package/dist/api/swagger-source.d.ts

@@ -0,0 +1,11 @@
+export interface SwaggerSource {
+    baseUrl: string;
+    cacheDir: string;
+    timeoutMs: number;
+    bearer?: string;
+}
+export interface FetchedSwagger {
+    raw: string;
+    origin: 'instance' | 'cache';
+}
+export declare const fetchSwagger: (source: SwaggerSource) => Promise<FetchedSwagger>;

package/dist/api/swagger-source.js

@@ -0,0 +1,58 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const SWAGGER_PATH = '/workflows/nodes/admin-api/swagger.json';
+const LANG_CODE = 'en_US';
+const cacheFile = (source) => join(source.cacheDir, 'swagger', `${createHash('sha256').update(source.baseUrl).digest('hex').slice(0, 16)}.json`);
+const readCache = (source) => {
+    try {
+        return readFileSync(cacheFile(source), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+};
+const writeCache = (source, raw) => {
+    const file = cacheFile(source);
+    mkdirSync(join(source.cacheDir, 'swagger'), { recursive: true });
+    writeFileSync(file, raw);
+};
+export const fetchSwagger = async (source) => {
+    const url = `${source.baseUrl}${SWAGGER_PATH}?langCode=${LANG_CODE}`;
+    const request = async (bearer) => fetch(url, {
+        headers: {
+            accept: 'application/json',
+            ...(bearer ? { authorization: `Bearer ${bearer}` } : {}),
+        },
+        signal: AbortSignal.timeout(source.timeoutMs),
+    });
+    try {
+        let response = await request();
+        if ((response.status === 401 || response.status === 403) && source.bearer) {
+            response = await request(source.bearer);
+        }
+        if (!response.ok) {
+            throw new Error(`${source.baseUrl} answered ${String(response.status)} for ${SWAGGER_PATH}` +
+                (response.status === 401 || response.status === 403
+                    ? ' — the instance requires credentials to read its API document'
+                    : ''));
+        }
+        const raw = await response.text();
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            !('paths' in parsed) ||
+            typeof parsed.paths !== 'object') {
+            throw new Error(`${source.baseUrl}${SWAGGER_PATH} did not answer with an OpenAPI document`);
+        }
+        writeCache(source, raw);
+        return { raw, origin: 'instance' };
+    }
+    catch (error) {
+        const cached = readCache(source);
+        if (cached) {
+            return { raw: cached, origin: 'cache' };
+        }
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+};

package/dist/api/types.d.ts

@@ -1,25 +1,13 @@
-/** HTTP-методы, встречающиеся в Admin API. */
 export type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
-/**
- * Класс риска операции. Определяется на сборке каталога, а не в рантайме,
- * чтобы политику доступа нельзя было обойти хитрым аргументом.
- */
 export type RiskLevel = 'read' | 'write' | 'destructive';
-/** Параметр операции (path / query / header). */
 export interface OperationParam {
     name: string;
     location: 'path' | 'query' | 'header';
     required: boolean;
     description?: string;
-    /** Нормализованная JSON-схема параметра. */
     schema: JsonSchema;
     example?: unknown;
 }
-/**
- * Нормализованная JSON-схема. Swagger проекта содержит 311 TypeScript-подобных
- * значений `type` (`Record<string, any>`, `CommonLocalizeInfos`, `image`…),
- * поэтому «схема» здесь — результат приведения, а не исходник.
- */
 export interface JsonSchema {
     type?: string;
     format?: string;
@@ -29,28 +17,19 @@ export interface JsonSchema {
     items?: JsonSchema;
     properties?: Record<string, JsonSchema>;
     required?: string[];
-    /** Тип не удалось привести к JSON Schema: доверять следует `example`. */
     'x-loose'?: boolean;
-    /** Исходный TypeScript-подобный тип из swagger — сохранён как подсказка. */
     'x-source-type'?: string;
-    /** Схема была урезана по размеру. */
     'x-truncated'?: boolean;
 }
-/** Одна операция Admin API в каталоге. */
 export interface Operation {
-    /** `operationId` из swagger, например `AdminPagesController_findAllRoot`. */
     opId: string;
     method: HttpMethod;
-    /** Путь без префикса API, например `/pages/{id}`. */
     path: string;
-    /** Полный путь как в swagger, например `/api/admin/pages/{id}`. */
     fullPath: string;
     tag: string;
     summary: string;
-    /** Требуемое право из `AdminPermissionsEnum`, если объявлено в контроллере. */
     permission?: string;
     risk: RiskLevel;
-    /** Операция навсегда остаётся за подтверждением, независимо от уровня allow. */
     alwaysConfirm: boolean;
     params: OperationParam[];
     body?: {
@@ -59,27 +38,14 @@ export interface Operation {
         required: boolean;
     };
     responseSummary?: string;
-    /** Идентификаторы разделов документации (`<docId>#<anchor>`), объясняющих операцию. */
-    docLinks: string[];
-    /** Склеенный текст для поиска по каталогу. */
     searchText: string;
 }
-/** Собранный каталог: то, что build-catalog.ts пишет в data/catalog.json. */
 export interface Catalog {
     version: 1;
     builtAt: string;
-    /** Префикс путей из swagger (`/api/admin`) — проверяется при сборке. */
     apiPrefix: string;
-    /** Хэш исходного swagger.json — виден в cms_whoami, ловит рассинхрон. */
     swaggerHash: string;
-    /** Полный список значений `AdminPermissionsEnum`. */
     permissions: string[];
-    /**
-     * Замечания сборки — прежде всего признаки устаревшего swagger.json.
-     * Показываются в `cms_whoami`: рассинхрон каталога и реального API должен быть
-     * виден агенту, а не выясняться по 404.
-     */
     warnings: string[];
     operations: Operation[];
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/api/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/bin/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.js

@@ -11,8 +11,6 @@ Options
   --base-url <url>        Admin API base URL (must contain /api/admin)
   --allow <level>         read (default) | write | destructive
   --login <login>         admin login; the password comes from ONEENTRY_CMS_PASSWORD
-  --back <path>           backend-app checkout: read knowledge live instead of the bundled snapshot
-  --front <path>          frontend-app checkout
   --audit <path>          JSONL audit log (required in remote mode)
   --http                  serve Streamable HTTP instead of stdio
   --port <n>              HTTP port, default 8931
@@ -21,9 +19,19 @@ Options
   --request-timeout <ms>  per-request timeout, default 30000
   --max-response-bytes <n> response cap handed to the model, default 24576
 
+Knowledge (documentation is fetched from GitHub, not bundled)
+  --knowledge-repo <o/n>  knowledge repository, default ONEENTRY-PLATFORM/oneentry-platform-rules
+  --knowledge-ref <ref>   branch, tag or commit, default main
+  --knowledge-path <dir>  read a local clone instead of GitHub (fast edit loop)
+  --knowledge-ttl <ms>    how long a cached commit stays fresh, default 3600000
+  --cache-dir <path>      where the knowledge tree and the API document are cached
+  --offline               never touch the network: cache and bundled rules only
+
 Environment
   ONEENTRY_CMS_LOGIN, ONEENTRY_CMS_PASSWORD, ONEENTRY_CMS_TOKEN, ONEENTRY_CMS_BASE_URL, ONEENTRY_MCP_ALLOW,
-  ONEENTRY_MCP_BACK_PATH, ONEENTRY_MCP_FRONT_PATH, ONEENTRY_MCP_AUDIT_PATH, ONEENTRY_MCP_PORT, ONEENTRY_MCP_HOST
+  ONEENTRY_MCP_AUDIT_PATH, ONEENTRY_MCP_PORT, ONEENTRY_MCP_HOST, ONEENTRY_MCP_CACHE_DIR,
+  ONEENTRY_MCP_KNOWLEDGE_REPO, ONEENTRY_MCP_KNOWLEDGE_REF, ONEENTRY_MCP_KNOWLEDGE_PATH,
+  ONEENTRY_MCP_KNOWLEDGE_TTL_MS, ONEENTRY_MCP_OFFLINE, ONEENTRY_GITHUB_TOKEN
 `;
 const main = async () => {
     const argv = process.argv.slice(2);
@@ -39,10 +47,6 @@ const main = async () => {
     await runStdio(config);
 };
 main().catch((error) => {
-    /**
-     * В stdio-режиме stdout занят протоколом, поэтому любая диагностика идёт в stderr.
-     */
     process.stderr.write(`oneentry-mcp-platform: ${error instanceof Error ? error.message : String(error)}\n`);
     process.exitCode = 1;
 });
-//# sourceMappingURL=cli.js.map

package/dist/config/config.d.ts

@@ -1,45 +1,67 @@
 import { z } from 'zod';
-/**
- * Уровень разрешённых операций.
- * Читаем по умолчанию: агент не может ничего испортить, пока человек явно не разрешил.
- */
 export declare const AllowLevelSchema: z.ZodEnum<["read", "write", "destructive"]>;
 export type AllowLevel = z.infer<typeof AllowLevelSchema>;
-/**
- * Режим работы сервера. Определяется транспортом, а не отдельным флагом:
- * stdio -> local (агент и CMS на одной машине), streamable HTTP -> remote (сервис).
- */
 export declare const ServerModeSchema: z.ZodEnum<["local", "remote"]>;
 export type ServerMode = z.infer<typeof ServerModeSchema>;
-/**
- * Полная конфигурация сервера после слияния источников.
- * Все дальнейшие слои получают её как зависимость и не читают process.env сами —
- * это то, что позволяет держать один и тот же код для local и remote.
- */
+export declare const KnowledgeConfigSchema: z.ZodObject<{
+    repo: z.ZodString;
+    ref: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    refreshTtlMs: z.ZodNumber;
+    offline: z.ZodBoolean;
+    token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    repo: string;
+    ref: string;
+    refreshTtlMs: number;
+    offline: boolean;
+    path?: string | undefined;
+    token?: string | undefined;
+}, {
+    repo: string;
+    ref: string;
+    refreshTtlMs: number;
+    offline: boolean;
+    path?: string | undefined;
+    token?: string | undefined;
+}>;
+export type KnowledgeSettings = z.infer<typeof KnowledgeConfigSchema>;
 export declare const ConfigSchema: z.ZodObject<{
     mode: z.ZodEnum<["local", "remote"]>;
-    /** Базовый URL Admin API, всегда с префиксом /api/admin и без завершающего слэша. */
     baseUrl: z.ZodString;
     allow: z.ZodEnum<["read", "write", "destructive"]>;
-    /** Логин/пароль админа. В remote-режиме могут отсутствовать — тогда их даёт сессия. */
     login: z.ZodOptional<z.ZodString>;
     password: z.ZodOptional<z.ZodString>;
-    /** Готовый access-токен вместо логина/пароля. */
     token: z.ZodOptional<z.ZodString>;
-    /** Путь к чекауту dnk-back: включает чтение документации «живьём» вместо снапшота. */
-    backPath: z.ZodOptional<z.ZodString>;
-    /** Путь к чекауту dnk-front. */
-    frontPath: z.ZodOptional<z.ZodString>;
-    /** Файл JSONL-аудита. В remote-режиме обязателен. */
+    knowledge: z.ZodObject<{
+        repo: z.ZodString;
+        ref: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        refreshTtlMs: z.ZodNumber;
+        offline: z.ZodBoolean;
+        token: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        repo: string;
+        ref: string;
+        refreshTtlMs: number;
+        offline: boolean;
+        path?: string | undefined;
+        token?: string | undefined;
+    }, {
+        repo: string;
+        ref: string;
+        refreshTtlMs: number;
+        offline: boolean;
+        path?: string | undefined;
+        token?: string | undefined;
+    }>;
+    cacheDir: z.ZodString;
     auditPath: z.ZodOptional<z.ZodString>;
-    /** Таймаут одного запроса к Admin API, мс. */
     requestTimeoutMs: z.ZodNumber;
-    /** Максимальный размер сериализованного ответа, отдаваемого модели, в байтах. */
     maxResponseBytes: z.ZodNumber;
     http: z.ZodObject<{
         port: z.ZodNumber;
         host: z.ZodString;
-        /** Разрешённые Origin для remote-режима. Пустой список = принимать только запросы без Origin. */
         allowedOrigins: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
         port: number;
@@ -54,6 +76,15 @@ export declare const ConfigSchema: z.ZodObject<{
     mode: "local" | "remote";
     baseUrl: string;
     allow: "read" | "write" | "destructive";
+    knowledge: {
+        repo: string;
+        ref: string;
+        refreshTtlMs: number;
+        offline: boolean;
+        path?: string | undefined;
+        token?: string | undefined;
+    };
+    cacheDir: string;
     requestTimeoutMs: number;
     maxResponseBytes: number;
     http: {
@@ -61,16 +92,23 @@ export declare const ConfigSchema: z.ZodObject<{
         host: string;
         allowedOrigins: string[];
     };
+    token?: string | undefined;
     login?: string | undefined;
     password?: string | undefined;
-    token?: string | undefined;
-    backPath?: string | undefined;
-    frontPath?: string | undefined;
     auditPath?: string | undefined;
 }, {
     mode: "local" | "remote";
     baseUrl: string;
     allow: "read" | "write" | "destructive";
+    knowledge: {
+        repo: string;
+        ref: string;
+        refreshTtlMs: number;
+        offline: boolean;
+        path?: string | undefined;
+        token?: string | undefined;
+    };
+    cacheDir: string;
     requestTimeoutMs: number;
     maxResponseBytes: number;
     http: {
@@ -78,31 +116,13 @@ export declare const ConfigSchema: z.ZodObject<{
         host: string;
         allowedOrigins: string[];
     };
+    token?: string | undefined;
     login?: string | undefined;
     password?: string | undefined;
-    token?: string | undefined;
-    backPath?: string | undefined;
-    frontPath?: string | undefined;
     auditPath?: string | undefined;
 }>;
 export type Config = z.infer<typeof ConfigSchema>;
-/** Разобранные аргументы командной строки. */
 export type CliFlags = Record<string, string | boolean>;
-/**
- * Минимальный разбор argv: поддерживаются `--flag`, `--key=value` и `--key value`.
- * Своя реализация вместо зависимости — набор флагов маленький и стабильный.
- */
 export declare const parseFlags: (argv: readonly string[]) => CliFlags;
-/**
- * Нормализует базовый URL: убирает завершающий слэш и требует префикс Admin API.
- * Сервер работает только с админским API — это гарантия, а не соглашение,
- * поэтому проверка живёт здесь, а не в клиенте.
- */
 export declare const normalizeBaseUrl: (raw: string) => string;
-/**
- * Собирает конфигурацию по приоритету: флаги > переменные окружения > ./oneentry-mcp-platform.json > дефолты.
- * Валидация одна и та же для обоих режимов; отличается только то, что в remote-режиме
- * обязателен путь аудита, а документация всегда берётся из снапшота.
- */
 export declare const loadConfig: (argv: readonly string[], env?: NodeJS.ProcessEnv, cwd?: string) => Config;
-//# sourceMappingURL=config.d.ts.map

package/dist/config/config.js

@@ -1,45 +1,32 @@
 import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { resolve } from 'node:path';
 import { z } from 'zod';
-/**
- * Уровень разрешённых операций.
- * Читаем по умолчанию: агент не может ничего испортить, пока человек явно не разрешил.
- */
 export const AllowLevelSchema = z.enum(['read', 'write', 'destructive']);
-/**
- * Режим работы сервера. Определяется транспортом, а не отдельным флагом:
- * stdio -> local (агент и CMS на одной машине), streamable HTTP -> remote (сервис).
- */
 export const ServerModeSchema = z.enum(['local', 'remote']);
-/**
- * Полная конфигурация сервера после слияния источников.
- * Все дальнейшие слои получают её как зависимость и не читают process.env сами —
- * это то, что позволяет держать один и тот же код для local и remote.
- */
+export const KnowledgeConfigSchema = z.object({
+    repo: z.string().regex(/^[\w.-]+\/[\w.-]+$/, 'knowledge repo must look like "owner/name"'),
+    ref: z.string().min(1),
+    path: z.string().optional(),
+    refreshTtlMs: z.number().int().nonnegative(),
+    offline: z.boolean(),
+    token: z.string().min(1).optional(),
+});
 export const ConfigSchema = z.object({
     mode: ServerModeSchema,
-    /** Базовый URL Admin API, всегда с префиксом /api/admin и без завершающего слэша. */
     baseUrl: z.string().url(),
     allow: AllowLevelSchema,
-    /** Логин/пароль админа. В remote-режиме могут отсутствовать — тогда их даёт сессия. */
     login: z.string().min(1).optional(),
     password: z.string().min(1).optional(),
-    /** Готовый access-токен вместо логина/пароля. */
     token: z.string().min(1).optional(),
-    /** Путь к чекауту dnk-back: включает чтение документации «живьём» вместо снапшота. */
-    backPath: z.string().optional(),
-    /** Путь к чекауту dnk-front. */
-    frontPath: z.string().optional(),
-    /** Файл JSONL-аудита. В remote-режиме обязателен. */
+    knowledge: KnowledgeConfigSchema,
+    cacheDir: z.string().min(1),
     auditPath: z.string().optional(),
-    /** Таймаут одного запроса к Admin API, мс. */
     requestTimeoutMs: z.number().int().positive(),
-    /** Максимальный размер сериализованного ответа, отдаваемого модели, в байтах. */
     maxResponseBytes: z.number().int().positive(),
     http: z.object({
         port: z.number().int().min(1).max(65535),
         host: z.string().min(1),
-        /** Разрешённые Origin для remote-режима. Пустой список = принимать только запросы без Origin. */
         allowedOrigins: z.array(z.string()),
     }),
 });
@@ -50,11 +37,10 @@ const DEFAULTS = {
     maxResponseBytes: 24_576,
     httpPort: 8931,
     httpHost: '127.0.0.1',
+    knowledgeRepo: 'ONEENTRY-PLATFORM/oneentry-platform-rules',
+    knowledgeRef: 'main',
+    knowledgeTtlMs: 3_600_000,
 };
-/**
- * Минимальный разбор argv: поддерживаются `--flag`, `--key=value` и `--key value`.
- * Своя реализация вместо зависимости — набор флагов маленький и стабильный.
- */
 export const parseFlags = (argv) => {
     const flags = {};
     for (let i = 0; i < argv.length; i++) {
@@ -80,6 +66,19 @@ export const parseFlags = (argv) => {
     return flags;
 };
 const asString = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
+const asBoolean = (value, fallback) => {
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+};
+const defaultCacheDir = (env) => {
+    const xdg = asString(env['XDG_CACHE_HOME']);
+    return resolve(xdg ?? resolve(homedir(), '.cache'), 'oneentry-mcp-platform');
+};
 const asNumber = (value, fallback) => {
     if (value === undefined) {
         return fallback;
@@ -90,11 +89,6 @@ const asNumber = (value, fallback) => {
     }
     return parsed;
 };
-/**
- * Нормализует базовый URL: убирает завершающий слэш и требует префикс Admin API.
- * Сервер работает только с админским API — это гарантия, а не соглашение,
- * поэтому проверка живёт здесь, а не в клиенте.
- */
 export const normalizeBaseUrl = (raw) => {
     const trimmed = raw.replace(/\/+$/, '');
     if (!trimmed.includes('/api/admin')) {
@@ -119,11 +113,6 @@ const readConfigFile = (cwd) => {
         throw error;
     }
 };
-/**
- * Собирает конфигурацию по приоритету: флаги > переменные окружения > ./oneentry-mcp-platform.json > дефолты.
- * Валидация одна и та же для обоих режимов; отличается только то, что в remote-режиме
- * обязателен путь аудита, а документация всегда берётся из снапшота.
- */
 export const loadConfig = (argv, env = process.env, cwd = process.cwd()) => {
     const flags = parseFlags(argv);
     const file = readConfigFile(cwd);
@@ -132,6 +121,15 @@ export const loadConfig = (argv, env = process.env, cwd = process.cwd()) => {
         return typeof value === 'string' && value.length > 0 ? value : undefined;
     };
     const pick = (flagKey, envKey, fileKey) => asString(flags[flagKey]) ?? asString(env[envKey]) ?? fileString(fileKey);
+    const fileKnowledge = file['knowledge'];
+    const knowledgeFile = (key) => {
+        if (typeof fileKnowledge !== 'object' || fileKnowledge === null || Array.isArray(fileKnowledge)) {
+            return undefined;
+        }
+        const value = fileKnowledge[key];
+        return typeof value === 'string' && value.length > 0 ? value : undefined;
+    };
+    const pickKnowledge = (flagKey, envKey, fileKey) => asString(flags[flagKey]) ?? asString(env[envKey]) ?? knowledgeFile(fileKey);
     const mode = flags['http'] === true || asString(flags['http']) ? 'remote' : 'local';
     const originsRaw = pick('allowed-origins', 'ONEENTRY_MCP_ALLOWED_ORIGINS', 'allowedOrigins');
     const candidate = {
@@ -141,8 +139,17 @@ export const loadConfig = (argv, env = process.env, cwd = process.cwd()) => {
         login: pick('login', 'ONEENTRY_CMS_LOGIN', 'login'),
         password: asString(env['ONEENTRY_CMS_PASSWORD']) ?? fileString('password'),
         token: asString(env['ONEENTRY_CMS_TOKEN']) ?? fileString('token'),
-        backPath: pick('back', 'ONEENTRY_MCP_BACK_PATH', 'backPath'),
-        frontPath: pick('front', 'ONEENTRY_MCP_FRONT_PATH', 'frontPath'),
+        knowledge: {
+            repo: pickKnowledge('knowledge-repo', 'ONEENTRY_MCP_KNOWLEDGE_REPO', 'repo') ??
+                DEFAULTS.knowledgeRepo,
+            ref: pickKnowledge('knowledge-ref', 'ONEENTRY_MCP_KNOWLEDGE_REF', 'ref') ??
+                DEFAULTS.knowledgeRef,
+            path: pickKnowledge('knowledge-path', 'ONEENTRY_MCP_KNOWLEDGE_PATH', 'path'),
+            refreshTtlMs: asNumber(pickKnowledge('knowledge-ttl', 'ONEENTRY_MCP_KNOWLEDGE_TTL_MS', 'refreshTtlMs'), DEFAULTS.knowledgeTtlMs),
+            offline: asBoolean(flags['offline'] ?? env['ONEENTRY_MCP_OFFLINE'], false),
+            token: asString(env['ONEENTRY_GITHUB_TOKEN']),
+        },
+        cacheDir: pick('cache-dir', 'ONEENTRY_MCP_CACHE_DIR', 'cacheDir') ?? defaultCacheDir(env),
         auditPath: pick('audit', 'ONEENTRY_MCP_AUDIT_PATH', 'auditPath'),
         requestTimeoutMs: asNumber(pick('request-timeout', 'ONEENTRY_MCP_REQUEST_TIMEOUT_MS', 'requestTimeoutMs'), DEFAULTS.requestTimeoutMs),
         maxResponseBytes: asNumber(pick('max-response-bytes', 'ONEENTRY_MCP_MAX_RESPONSE_BYTES', 'maxResponseBytes'), DEFAULTS.maxResponseBytes),
@@ -153,9 +160,6 @@ export const loadConfig = (argv, env = process.env, cwd = process.cwd()) => {
         },
     };
     const config = ConfigSchema.parse(candidate);
-    /**
-     * Пароль через флаг не принимаем ни в каком режиме: argv видно в списке процессов.
-     */
     if (asString(flags['password'])) {
         throw new Error('Refusing --password: pass ONEENTRY_CMS_PASSWORD via the environment instead.');
     }
@@ -164,4 +168,3 @@ export const loadConfig = (argv, env = process.env, cwd = process.cwd()) => {
     }
     return config;
 };
-//# sourceMappingURL=config.js.map

package/dist/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * Публичный API пакета: всё, что нужно, чтобы встроить сервер в свой процесс
- * или собрать его иначе, чем это делает CLI.
- */
 export { loadConfig, parseFlags, normalizeBaseUrl, ConfigSchema } from './config/config.js';
 export type { Config, AllowLevel, ServerMode } from './config/config.js';
 export { createServer, createSharedDeps } from './server.js';
@@ -15,9 +11,15 @@ export { shapeResponse } from './api/shape.js';
 export { AuditLog } from './api/audit.js';
 export { TokenStore, AuthError } from './api/auth.js';
 export { KnowledgeIndex } from './knowledge/search.js';
-export { buildPack, loadSnapshot, resolveKnowledge } from './knowledge/loader.js';
+export { packFromFiles, resolveKnowledge, seedPack } from './knowledge/loader.js';
+export type { KnowledgeConfig } from './knowledge/loader.js';
+export { fetchKnowledgeTree, readLocalTree } from './knowledge/github.js';
+export type { KnowledgeFile, KnowledgeSource, KnowledgeTree } from './knowledge/github.js';
+export { readTar, readTarGz } from './knowledge/tar.js';
+export { buildCatalog } from './api/build-catalog.js';
+export type { PermissionMap } from './api/build-catalog.js';
+export { fetchSwagger } from './api/swagger-source.js';
 export { runStdio } from './transports/stdio.js';
 export { runHttp } from './transports/http.js';
 export type { Catalog, Operation, JsonSchema, RiskLevel } from './api/types.js';
-export type { KnowledgeChunk, KnowledgeDoc, KnowledgePack } from './knowledge/types.js';
-//# sourceMappingURL=index.d.ts.map
+export type { KnowledgeChunk, KnowledgeDoc, KnowledgeOrigin, KnowledgePack, } from './knowledge/types.js';