@oneentry/mcp-platform-server 0.1.0

package/dist/config/config.d.ts

@@ -0,0 +1,108 @@
+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 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-режиме обязателен. */
+    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;
+        host: string;
+        allowedOrigins: string[];
+    }, {
+        port: number;
+        host: string;
+        allowedOrigins: string[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    mode: "local" | "remote";
+    baseUrl: string;
+    allow: "read" | "write" | "destructive";
+    requestTimeoutMs: number;
+    maxResponseBytes: number;
+    http: {
+        port: number;
+        host: string;
+        allowedOrigins: string[];
+    };
+    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";
+    requestTimeoutMs: number;
+    maxResponseBytes: number;
+    http: {
+        port: number;
+        host: string;
+        allowedOrigins: string[];
+    };
+    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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,6CAA2C,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gCAA8B,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,YAAY;;IAEvB,qFAAqF;;;IAGrF,uFAAuF;;;IAGvF,iDAAiD;;IAEjD,sFAAsF;;IAEtF,gCAAgC;;IAEhC,qDAAqD;;IAErD,8CAA8C;;IAE9C,iFAAiF;;;;;QAK/E,iGAAiG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGnG,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAWlD,8CAA8C;AAC9C,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,SAAS,MAAM,EAAE,KAAG,QAsBpD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAS9C,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,SAAS,MAAM,EAAE,EACvB,MAAK,MAAM,CAAC,UAAwB,EACpC,MAAK,MAAsB,KAC1B,MAsDF,CAAC"}

package/dist/config/config.js

@@ -0,0 +1,167 @@
+import { readFileSync } from 'node:fs';
+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 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-режиме обязателен. */
+    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()),
+    }),
+});
+const DEFAULTS = {
+    baseUrl: 'http://localhost:3003/api/admin',
+    allow: 'read',
+    requestTimeoutMs: 30_000,
+    maxResponseBytes: 24_576,
+    httpPort: 8931,
+    httpHost: '127.0.0.1',
+};
+/**
+ * Минимальный разбор argv: поддерживаются `--flag`, `--key=value` и `--key value`.
+ * Своя реализация вместо зависимости — набор флагов маленький и стабильный.
+ */
+export const parseFlags = (argv) => {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg || !arg.startsWith('--')) {
+            continue;
+        }
+        const body = arg.slice(2);
+        const eq = body.indexOf('=');
+        if (eq !== -1) {
+            flags[body.slice(0, eq)] = body.slice(eq + 1);
+            continue;
+        }
+        const next = argv[i + 1];
+        if (next && !next.startsWith('--')) {
+            flags[body] = next;
+            i++;
+        }
+        else {
+            flags[body] = true;
+        }
+    }
+    return flags;
+};
+const asString = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
+const asNumber = (value, fallback) => {
+    if (value === undefined) {
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`Expected a number, got "${value}"`);
+    }
+    return parsed;
+};
+/**
+ * Нормализует базовый URL: убирает завершающий слэш и требует префикс Admin API.
+ * Сервер работает только с админским API — это гарантия, а не соглашение,
+ * поэтому проверка живёт здесь, а не в клиенте.
+ */
+export const normalizeBaseUrl = (raw) => {
+    const trimmed = raw.replace(/\/+$/, '');
+    if (!trimmed.includes('/api/admin')) {
+        throw new Error(`baseUrl must point at the Admin API (…/api/admin), got "${raw}". ` +
+            'This server intentionally exposes the Admin API only.');
+    }
+    return trimmed;
+};
+const readConfigFile = (cwd) => {
+    try {
+        const raw = readFileSync(resolve(cwd, 'oneentry-mcp-platform.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('oneentry-mcp-platform.json must contain a JSON object');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {};
+        }
+        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);
+    const fileString = (key) => {
+        const value = file[key];
+        return typeof value === 'string' && value.length > 0 ? value : undefined;
+    };
+    const pick = (flagKey, envKey, fileKey) => asString(flags[flagKey]) ?? asString(env[envKey]) ?? fileString(fileKey);
+    const mode = flags['http'] === true || asString(flags['http']) ? 'remote' : 'local';
+    const originsRaw = pick('allowed-origins', 'ONEENTRY_MCP_ALLOWED_ORIGINS', 'allowedOrigins');
+    const candidate = {
+        mode,
+        baseUrl: normalizeBaseUrl(pick('base-url', 'ONEENTRY_CMS_BASE_URL', 'baseUrl') ?? DEFAULTS.baseUrl),
+        allow: AllowLevelSchema.parse(pick('allow', 'ONEENTRY_MCP_ALLOW', 'allow') ?? DEFAULTS.allow),
+        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'),
+        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),
+        http: {
+            port: asNumber(pick('port', 'ONEENTRY_MCP_PORT', 'port'), DEFAULTS.httpPort),
+            host: pick('host', 'ONEENTRY_MCP_HOST', 'host') ?? DEFAULTS.httpHost,
+            allowedOrigins: originsRaw ? originsRaw.split(',').map((o) => o.trim()).filter(Boolean) : [],
+        },
+    };
+    const config = ConfigSchema.parse(candidate);
+    /**
+     * Пароль через флаг не принимаем ни в каком режиме: argv видно в списке процессов.
+     */
+    if (asString(flags['password'])) {
+        throw new Error('Refusing --password: pass ONEENTRY_CMS_PASSWORD via the environment instead.');
+    }
+    if (config.mode === 'remote' && !config.auditPath) {
+        throw new Error('Remote mode requires --audit <path>: every mutation must be auditable.');
+    }
+    return config;
+};
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Публичный 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';
+export { Session } from './session.js';
+export type { SharedDeps } from './session.js';
+export { OperationCatalog } from './api/catalog.js';
+export { AdminApiClient, buildUrl, RequestBuildError } from './api/client.js';
+export { ConfirmStore, decide } from './api/policy.js';
+export type { PolicyDecision } from './api/policy.js';
+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 { 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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,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;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,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;AAC/C,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * Публичный API пакета: всё, что нужно, чтобы встроить сервер в свой процесс
+ * или собрать его иначе, чем это делает CLI.
+ */
+export { loadConfig, parseFlags, normalizeBaseUrl, ConfigSchema } from './config/config.js';
+export { createServer, createSharedDeps } from './server.js';
+export { Session } from './session.js';
+export { OperationCatalog } from './api/catalog.js';
+export { AdminApiClient, buildUrl, RequestBuildError } from './api/client.js';
+export { ConfirmStore, decide } from './api/policy.js';
+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 { runStdio } from './transports/stdio.js';
+export { runHttp } from './transports/http.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,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

@@ -0,0 +1,35 @@
+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"];
+    path: string;
+    markdown: string;
+}) => {
+    doc: KnowledgeDoc;
+    chunks: KnowledgeChunk[];
+};
+export {};
+//# sourceMappingURL=chunk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/knowledge/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,MAMzB,CAAC;AAKlB,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CA6BvF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAG;IAAE,GAAG,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAqChD,CAAC"}

package/dist/knowledge/chunk.js

@@ -0,0 +1,87 @@
+/**
+ * Слаг заголовка в стиле 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 = '';
+    const sections = [{ title: '', lines: [] }];
+    let inFence = false;
+    for (const line of lines) {
+        if (isFence(line)) {
+            inFence = !inFence;
+        }
+        if (!inFence) {
+            const h1 = /^#\s+(.*)$/.exec(line);
+            if (h1 && !docTitle) {
+                docTitle = (h1[1] ?? '').trim();
+                continue;
+            }
+            const heading = /^(##|###)\s+(.*)$/.exec(line);
+            if (heading) {
+                sections.push({ title: (heading[2] ?? '').trim(), lines: [] });
+                continue;
+            }
+        }
+        sections[sections.length - 1]?.lines.push(line);
+    }
+    return {
+        docTitle,
+        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();
+    const chunks = [];
+    for (const section of sections) {
+        const base = section.title === '' ? '' : slugify(section.title);
+        const count = seen.get(base) ?? 0;
+        seen.set(base, count + 1);
+        const anchor = count === 0 ? base : `${base}-${count + 1}`;
+        const text = section.lines.join('\n').trim();
+        chunks.push({
+            id: `${params.docId}#${anchor}`,
+            docId: params.docId,
+            repo: params.repo,
+            path: params.path,
+            anchor,
+            title: section.title === '' ? (docTitle || params.docId) : section.title,
+            docTitle: docTitle || params.docId,
+            text,
+        });
+    }
+    return {
+        doc: {
+            docId: params.docId,
+            repo: params.repo,
+            path: params.path,
+            title: docTitle || params.docId,
+            anchors: chunks.map((c) => ({
+                anchor: c.anchor,
+                title: c.title,
+                bytes: Buffer.byteLength(c.text, 'utf8'),
+            })),
+        },
+        chunks,
+    };
+};
+//# sourceMappingURL=chunk.js.map

package/dist/knowledge/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../src/knowledge/chunk.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAU,EAAE,CACjD,OAAO;KACJ,WAAW,EAAE;KACb,OAAO,CAAC,iDAAiD,EAAE,EAAE,CAAC;KAC9D,IAAI,EAAE;KACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;KACpB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAElB,sEAAsE;AACtE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAO5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAA6C,EAAE;IAC3F,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,MAAM,QAAQ,GAAc,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpB,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAK7B,EAAmD,EAAE;IACpD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;YACxE,QAAQ,EAAE,QAAQ,IAAI,MAAM,CAAC,KAAK;YAClC,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,GAAG,EAAE;YACH,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,QAAQ,IAAI,MAAM,CAAC,KAAK;YAC/B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;aACzC,CAAC,CAAC;SACJ;QACD,MAAM;KACP,CAAC;AACJ,CAAC,CAAC"}

package/dist/knowledge/loader.d.ts

@@ -0,0 +1,27 @@
+import type { KnowledgePack } from './types.js';
+/** Каталог со собственными знаниями пакета (operating-rules.md и т.п.). */
+export declare const ownKnowledgeDir: () => string;
+/** Каталог со собранными данными пакета (knowledge.json, catalog.json). */
+export declare const dataDir: () => string;
+/**
+ * Собирает пакет знаний из чекаутов. Используется и сборкой снапшота,
+ * и live-режимом, поэтому результат в обоих случаях идентичен по структуре.
+ */
+export declare const buildPack: (params: {
+    backPath?: string;
+    frontPath?: string;
+    source: KnowledgePack["source"];
+    builtAt: string;
+}) => KnowledgePack;
+/** Читает собранный снапшот из data/knowledge.json. */
+export declare const loadSnapshot: () => KnowledgePack;
+/**
+ * Выбирает источник знаний: живой чекаут, если он указан, иначе снапшот пакета.
+ * Live-режим нужен, чтобы правка документации в dnk-back действовала сразу,
+ * без переиздания npm-пакета.
+ */
+export declare const resolveKnowledge: (params: {
+    backPath?: string;
+    frontPath?: string;
+}) => KnowledgePack;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,125 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { chunkDocument } from './chunk.js';
+const BACK_SOURCES = [
+    { repo: 'back', subPath: '.claude/docs', docPrefix: 'back/docs' },
+    { repo: 'back', subPath: '.claude/tests', docPrefix: 'back/tests' },
+    { repo: 'back', subPath: '.claude/rules', docPrefix: 'back/rules' },
+    { repo: 'back', subPath: '.claude/fixes', docPrefix: 'back/fixes' },
+    { repo: 'back', subPath: '.claude/CLAUDE.md', docPrefix: 'back', singleFile: true },
+];
+const FRONT_SOURCES = [
+    { repo: 'front', subPath: '.claude/docs', docPrefix: 'front/docs' },
+    { repo: 'front', subPath: '.claude/rules', docPrefix: 'front/rules' },
+    { repo: 'front', subPath: '.claude/fixes', docPrefix: 'front/fixes' },
+];
+/** Рекурсивно собирает пути всех `*.md` внутри каталога. */
+const walkMarkdown = (root) => {
+    const out = [];
+    const visit = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                visit(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                out.push(full);
+            }
+        }
+    };
+    visit(root);
+    return out.sort();
+};
+const exists = (path) => {
+    try {
+        statSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const collectSource = (repoRoot, spec) => {
+    const target = resolve(repoRoot, spec.subPath);
+    const docs = [];
+    const chunks = [];
+    if (!exists(target)) {
+        return { docs, chunks };
+    }
+    const files = spec.singleFile ? [target] : walkMarkdown(target);
+    for (const file of files) {
+        const rel = spec.singleFile
+            ? file.split(sep).slice(-1).join('')
+            : relative(target, file);
+        const slug = rel.replace(/\.md$/, '').split(sep).join('/');
+        const docId = spec.docPrefix ? `${spec.docPrefix}/${slug}` : slug;
+        const result = chunkDocument({
+            docId,
+            repo: spec.repo,
+            path: relative(repoRoot, file).split(sep).join('/'),
+            markdown: readFileSync(file, 'utf8'),
+        });
+        docs.push(result.doc);
+        chunks.push(...result.chunks);
+    }
+    return { docs, chunks };
+};
+/** Каталог со собственными знаниями пакета (operating-rules.md и т.п.). */
+export const ownKnowledgeDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../knowledge');
+/** Каталог со собранными данными пакета (knowledge.json, catalog.json). */
+export const dataDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../data');
+/**
+ * Собирает пакет знаний из чекаутов. Используется и сборкой снапшота,
+ * и live-режимом, поэтому результат в обоих случаях идентичен по структуре.
+ */
+export const buildPack = (params) => {
+    const docs = [];
+    const chunks = [];
+    const own = collectSource(ownKnowledgeDir(), {
+        repo: 'mcp',
+        subPath: '.',
+        docPrefix: 'mcp',
+    });
+    docs.push(...own.docs);
+    chunks.push(...own.chunks);
+    const add = (root, specs) => {
+        if (!root) {
+            return;
+        }
+        for (const spec of specs) {
+            const result = collectSource(root, spec);
+            docs.push(...result.docs);
+            chunks.push(...result.chunks);
+        }
+    };
+    add(params.backPath, BACK_SOURCES);
+    add(params.frontPath, FRONT_SOURCES);
+    return { version: 1, builtAt: params.builtAt, source: params.source, docs, chunks };
+};
+/** Читает собранный снапшот из data/knowledge.json. */
+export const loadSnapshot = () => {
+    const file = resolve(dataDir(), 'knowledge.json');
+    const parsed = JSON.parse(readFileSync(file, 'utf8'));
+    if (parsed.version !== 1) {
+        throw new Error(`Unsupported knowledge pack version ${String(parsed.version)}`);
+    }
+    return parsed;
+};
+/**
+ * Выбирает источник знаний: живой чекаут, если он указан, иначе снапшот пакета.
+ * Live-режим нужен, чтобы правка документации в dnk-back действовала сразу,
+ * без переиздания npm-пакета.
+ */
+export const resolveKnowledge = (params) => {
+    if (params.backPath) {
+        return buildPack({
+            backPath: params.backPath,
+            frontPath: params.frontPath,
+            source: 'live',
+            builtAt: new Date().toISOString(),
+        });
+    }
+    return loadSnapshot();
+};
+//# sourceMappingURL=loader.js.map