team-chat 0.0.0-stage → 0.3.0

package/server/dist/src/documents/documents.service.js

@@ -0,0 +1,189 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsService = exports.STATUSES = exports.KINDS = void 0;
+const common_1 = require("@nestjs/common");
+const drizzle_orm_1 = require("drizzle-orm");
+const zod_1 = require("zod");
+const errors_1 = require("../common/errors");
+const format_1 = require("../common/format");
+const validation_1 = require("../common/validation");
+const database_module_1 = require("../db/database.module");
+const schema_1 = require("../db/schema");
+const participants_service_1 = require("../participants/participants.service");
+exports.KINDS = ['plan', 'audit', 'handoff', 'report', 'reference'];
+exports.STATUSES = ['draft', 'current', 'archived'];
+const writeSchema = zod_1.z.object({
+    slug: zod_1.z.string().max(200).regex(/^[a-z0-9][a-z0-9._-]*$/, {
+        error: 'Адрес документа — латиница, цифры, точка, дефис и подчёркивание.',
+    }),
+    title: zod_1.z.string().max(300),
+    body: zod_1.z.string().max(500_000),
+    kind: zod_1.z.enum(exports.KINDS),
+    status: zod_1.z.enum(exports.STATUSES).nullish(),
+    origin: (0, validation_1.optionalText)(300),
+    note: (0, validation_1.optionalText)(300),
+});
+const agentWriteSchema = zod_1.z.object({
+    slug: zod_1.z.string().max(200),
+    title: zod_1.z.string().max(300),
+    body: zod_1.z.string(),
+    kind: zod_1.z.enum(exports.KINDS),
+    status: zod_1.z.enum(exports.STATUSES).nullish(),
+    note: (0, validation_1.optionalText)(300),
+    // Куда документ ляжет при выгрузке в репозиторий, если его подтвердят.
+    path: (0, validation_1.optionalText)(300),
+});
+const updateSchema = zod_1.z.object({
+    status: zod_1.z.enum(exports.STATUSES).nullish(),
+    origin: (0, validation_1.optionalText)(300),
+    kind: zod_1.z.enum(exports.KINDS).nullish(),
+});
+/**
+ * Документы проекта: планы, аудиты, хендоффы. Тело не перезаписывается — каждая правка
+ * новая редакция. Подтвердить актуальность (current) может только владелец: тот же
+ * принцип, что с фиксацией решений.
+ */
+let DocumentsService = class DocumentsService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async list(chat, filter = {}) {
+        const rows = await this.db.select().from(schema_1.documents).where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.documents.chatId, chat.id), filter.status ? (0, drizzle_orm_1.eq)(schema_1.documents.status, filter.status) : undefined, filter.kind ? (0, drizzle_orm_1.eq)(schema_1.documents.kind, filter.kind) : undefined)).orderBy((0, drizzle_orm_1.asc)(schema_1.documents.slug));
+        const latest = await this.latestVersions(rows.map(d => d.id));
+        return rows.map(d => documentApi(d, latest.get(d.id)));
+    }
+    /** Документ целиком — с телом последней редакции и историей правок. */
+    async show(chat, slug) {
+        const document = await this.find(chat, slug);
+        if (!document)
+            throw (0, errors_1.notFound)();
+        const history = await this.db.select({ version: schema_1.documentVersions, author: schema_1.participants.handle }).from(schema_1.documentVersions)
+            .leftJoin(schema_1.participants, (0, drizzle_orm_1.eq)(schema_1.participants.id, schema_1.documentVersions.participantId))
+            .where((0, drizzle_orm_1.eq)(schema_1.documentVersions.documentId, document.id))
+            .orderBy((0, drizzle_orm_1.desc)(schema_1.documentVersions.revision));
+        return {
+            ...documentApi(document, history[0]?.version, true),
+            history: history.map(h => ({ revision: h.version.revision, note: h.version.note, author: h.author, at: (0, format_1.iso)(h.version.createdAt) })),
+        };
+    }
+    /** Для MCP: документ с телом, без истории — или null. */
+    async read(chat, slug) {
+        const document = await this.find(chat, slug);
+        if (!document)
+            return null;
+        return documentApi(document, (await this.latestVersions([document.id])).get(document.id), true);
+    }
+    /**
+     * Создать документ или добавить ему редакцию — из интерфейса. Новая редакция без явного
+     * статуса не меняет его, но только у владельца: правка не-владельца возвращает документ
+     * в черновик, иначе непроверенный текст остался бы «подтверждённым».
+     */
+    async write(chat, me, input) {
+        const data = (0, validation_1.validate)(writeSchema, input);
+        if (data.status === 'current' && !(0, participants_service_1.isOwner)(me))
+            throw (0, errors_1.forbidden)('Подтвердить документ может только владелец.');
+        const existing = await this.find(chat, data.slug);
+        const document = await this.put(chat, me, {
+            ...data,
+            status: data.status ?? ((0, participants_service_1.isOwner)(me) ? existing?.status ?? 'draft' : 'draft'),
+            origin: data.origin ?? existing?.origin ?? null,
+        });
+        return { document, created: !existing };
+    }
+    /**
+     * Запись агента через MCP: статус по умолчанию — черновик, подтверждение (current) —
+     * право владельца. Путь выгрузки — поле path; не передан — остаётся прежний.
+     */
+    async writeFromAgent(chat, me, input) {
+        const data = (0, validation_1.validate)(agentWriteSchema, input);
+        const status = data.status ?? 'draft';
+        if (status === 'current' && !(0, participants_service_1.isOwner)(me)) {
+            throw (0, errors_1.forbidden)('Статус current ставит только владелец. Сохрани как draft и попроси подтвердить в треде.');
+        }
+        const existing = await this.find(chat, data.slug);
+        const { body: _, ...document } = await this.put(chat, me, {
+            ...data, status, origin: data.path ?? existing?.origin ?? null,
+        });
+        return document;
+    }
+    /** Смена статуса, типа и пути выгрузки — без новой редакции. */
+    async update(chat, slug, me, input) {
+        const document = await this.find(chat, slug);
+        if (!document)
+            throw (0, errors_1.notFound)();
+        const data = (0, validation_1.validate)(updateSchema, input);
+        if (data.status === 'current' && !(0, participants_service_1.isOwner)(me))
+            throw (0, errors_1.forbidden)('Подтвердить документ может только владелец.');
+        const changes = Object.fromEntries(Object.entries(data).filter(([, v]) => v != null));
+        const [updated] = Object.keys(changes).length
+            ? await this.db.update(schema_1.documents).set(changes).where((0, drizzle_orm_1.eq)(schema_1.documents.id, document.id)).returning()
+            : [document];
+        return documentApi(updated, (await this.latestVersions([document.id])).get(document.id));
+    }
+    /**
+     * Создать документ или добавить редакцию. Прошлые редакции остаются читаемыми.
+     * Общий путь для интерфейса, MCP и импорта из репозиториев.
+     */
+    async put(chat, author, doc) {
+        return this.db.transaction(async (tx) => {
+            const [document] = await tx.insert(schema_1.documents).values({
+                chatId: chat.id, slug: doc.slug, title: doc.title, kind: doc.kind, status: doc.status,
+                origin: doc.origin, participantId: author?.id ?? null,
+            }).onConflictDoUpdate({
+                target: [schema_1.documents.chatId, schema_1.documents.slug],
+                set: { title: doc.title, kind: doc.kind, status: doc.status, origin: doc.origin },
+            }).returning();
+            const [{ last }] = await tx.select({ last: (0, drizzle_orm_1.max)(schema_1.documentVersions.revision) }).from(schema_1.documentVersions)
+                .where((0, drizzle_orm_1.eq)(schema_1.documentVersions.documentId, document.id));
+            const [version] = await tx.insert(schema_1.documentVersions).values({
+                documentId: document.id, revision: (last ?? 0) + 1, body: doc.body,
+                participantId: author?.id ?? null, note: doc.note ?? null,
+            }).returning();
+            return documentApi(document, version, true);
+        });
+    }
+    async find(chat, slug) {
+        const [row] = await this.db.select().from(schema_1.documents).where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.documents.chatId, chat.id), (0, drizzle_orm_1.eq)(schema_1.documents.slug, slug)));
+        return row ?? null;
+    }
+    async latestVersions(ids) {
+        if (ids.length === 0)
+            return new Map();
+        const rows = await this.db.select().from(schema_1.documentVersions)
+            .where((0, drizzle_orm_1.inArray)(schema_1.documentVersions.documentId, ids)).orderBy((0, drizzle_orm_1.asc)(schema_1.documentVersions.revision));
+        return new Map(rows.map(v => [v.documentId, v])); // последняя редакция перекрывает прежние
+    }
+};
+exports.DocumentsService = DocumentsService;
+exports.DocumentsService = DocumentsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(database_module_1.DATABASE)),
+    __metadata("design:paramtypes", [Object])
+], DocumentsService);
+/** Документ так, как его видят клиенты: пустые поля не отдаются вовсе. */
+function documentApi(d, version, withBody = false) {
+    const api = {
+        slug: d.slug,
+        title: d.title,
+        kind: d.kind,
+        status: d.status,
+        origin: d.origin,
+        revision: version?.revision,
+        updated_at: (0, format_1.iso)(d.updatedAt),
+        body: withBody ? version?.body : undefined,
+    };
+    return Object.fromEntries(Object.entries(api).filter(([, v]) => v !== null && v !== undefined));
+}

package/server/dist/src/health/health.controller.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthController = void 0;
+const common_1 = require("@nestjs/common");
+/** Жив ли сервер: по нему CLI ждёт запуска (team-chat start). Путь — как был у Laravel. */
+let HealthController = class HealthController {
+    up() {
+        return { status: 'ok' };
+    }
+};
+exports.HealthController = HealthController;
+__decorate([
+    (0, common_1.Get)('up'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], HealthController.prototype, "up", null);
+exports.HealthController = HealthController = __decorate([
+    (0, common_1.Controller)()
+], HealthController);

package/server/dist/src/knowledge/knowledge.controller.js

@@ -0,0 +1,83 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeController = void 0;
+const common_1 = require("@nestjs/common");
+const participant_guard_1 = require("../auth/participant.guard");
+const chats_service_1 = require("../chats/chats.service");
+const http_1 = require("../common/http");
+const knowledge_service_1 = require("./knowledge.service");
+/** Опыт агентов: мост присылает карточки, агенты ищут уроки, удаляет только владелец. */
+let KnowledgeController = class KnowledgeController {
+    chats;
+    knowledge;
+    constructor(chats, knowledge) {
+        this.chats = chats;
+        this.knowledge = knowledge;
+    }
+    /**
+     * С q — уроки, похожие на запрос: по всем чатам, свой выше. Без q — последние уроки чата.
+     * category — только этого типа задач (bug, task, search, review…).
+     */
+    async index(slug, q, limit, category) {
+        const chat = await this.chats.resolve(slug);
+        const lessons = q?.trim()
+            ? await this.knowledge.search(q, { chat, limit: (0, http_1.limitFrom)(limit, 5), category })
+            : await this.knowledge.lessons(chat, { limit: (0, http_1.limitFrom)(limit), category });
+        return { lessons, count: lessons.length };
+    }
+    /** Карточка запуска от моста: новая — 201, обновление той же записи запуска — 200. */
+    async store(me, slug, body, res) {
+        const { card, created } = await this.knowledge.save(await this.chats.bySlug(slug), me, body);
+        res.status(created ? 201 : 200);
+        return card;
+    }
+    remove(me, id) {
+        return this.knowledge.remove(me, id);
+    }
+};
+exports.KnowledgeController = KnowledgeController;
+__decorate([
+    (0, common_1.Get)(['chats/:chat/knowledge', 'knowledge']),
+    __param(0, (0, common_1.Param)('chat')),
+    __param(1, (0, common_1.Query)('q')),
+    __param(2, (0, common_1.Query)('limit')),
+    __param(3, (0, common_1.Query)('category')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String]),
+    __metadata("design:returntype", Promise)
+], KnowledgeController.prototype, "index", null);
+__decorate([
+    (0, common_1.Post)('chats/:chat/knowledge'),
+    __param(0, (0, participant_guard_1.Me)()),
+    __param(1, (0, common_1.Param)('chat')),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], KnowledgeController.prototype, "store", null);
+__decorate([
+    (0, common_1.Delete)('knowledge/:id'),
+    __param(0, (0, participant_guard_1.Me)()),
+    __param(1, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Number]),
+    __metadata("design:returntype", void 0)
+], KnowledgeController.prototype, "remove", null);
+exports.KnowledgeController = KnowledgeController = __decorate([
+    (0, common_1.Controller)('api'),
+    (0, common_1.UseGuards)(participant_guard_1.ParticipantGuard),
+    __metadata("design:paramtypes", [chats_service_1.ChatsService, knowledge_service_1.KnowledgeService])
+], KnowledgeController);

package/server/dist/src/knowledge/knowledge.module.js

@@ -0,0 +1,25 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeModule = void 0;
+const common_1 = require("@nestjs/common");
+const conversation_module_1 = require("../conversation.module");
+const knowledge_controller_1 = require("./knowledge.controller");
+const knowledge_service_1 = require("./knowledge.service");
+/** Опыт агентов — карточки запусков и уроки из них (docs/plan-2026-10-24-knowledge.md). */
+let KnowledgeModule = class KnowledgeModule {
+};
+exports.KnowledgeModule = KnowledgeModule;
+exports.KnowledgeModule = KnowledgeModule = __decorate([
+    (0, common_1.Module)({
+        imports: [conversation_module_1.ConversationModule],
+        providers: [knowledge_service_1.KnowledgeService],
+        controllers: [knowledge_controller_1.KnowledgeController],
+        exports: [knowledge_service_1.KnowledgeService],
+    })
+], KnowledgeModule);

package/server/dist/src/knowledge/knowledge.service.js

@@ -0,0 +1,189 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeService = exports.MAX_CARD = exports.cardSchema = exports.CATEGORIES = void 0;
+const common_1 = require("@nestjs/common");
+const drizzle_orm_1 = require("drizzle-orm");
+const zod_1 = require("zod");
+const errors_1 = require("../common/errors");
+const format_1 = require("../common/format");
+const validation_1 = require("../common/validation");
+const database_module_1 = require("../db/database.module");
+const schema_1 = require("../db/schema");
+const participants_service_1 = require("../participants/participants.service");
+/** Типы задач, как их ставит мост (host/knowledge/lesson.js). Сервер принимает и другие — данные ценнее порядка. */
+exports.CATEGORIES = 'bug, task, search, review, refactor, test, config, infra, performance, security, question, other';
+/** Поля урока — короткие фразы: мост режет их до 300 знаков, здесь — запас. */
+const phrase = () => zod_1.z.string().max(400).nullish();
+const phrases = () => zod_1.z.array(zod_1.z.string().max(400)).max(8).default([]);
+/** Карточка формата 1 — как её собирает мост (host/knowledge/card.js). Её же принимает сборщик. */
+exports.cardSchema = zod_1.z.object({
+    format: zod_1.z.literal(1),
+    stack: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    process: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    problem: zod_1.z.object({
+        category: zod_1.z.string().max(40),
+        area: phrase(),
+        symptom: phrase(),
+        root_cause: phrase(),
+    }).nullish(),
+    solution: zod_1.z.object({
+        approach: phrases(),
+        dead_ends: phrases(),
+        verified_by: phrase(),
+        rule: phrase(),
+        applies_when: phrase(),
+    }).nullish(),
+    outcome: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+});
+const saveSchema = zod_1.z.object({
+    key: zod_1.z.string().min(1).max(200),
+    card: exports.cardSchema,
+});
+/** Карточка целиком — в пределах разумного: в ней нет ни кода, ни вывода команд. */
+exports.MAX_CARD = 64_000;
+/** Сколько слов запроса идёт в поиск: вопрос бывает длинным, а смысл — в первых словах. */
+const MAX_QUERY_WORDS = 64;
+/**
+ * База знаний: карточки опыта агентов. Пишет мост после каждого запуска, читают агенты —
+ * мост кладёт похожие уроки в задание, агент ищет сам через find-knowledge. В поиск идут
+ * только карточки с уроком: факты без вывода агенту ничего не подскажут.
+ */
+let KnowledgeService = class KnowledgeService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Сохранить карточку запуска; та же запись запуска — та же карточка. */
+    async save(chat, me, input) {
+        const { key, card } = (0, validation_1.validate)(saveSchema, input);
+        if (JSON.stringify(card).length > exports.MAX_CARD)
+            throw errors_1.ValidationFailed.field('card', 'Карточка слишком большая.');
+        const values = { card, format: card.format, search: searchText(card) };
+        const [existing] = await this.db.select().from(schema_1.knowledgeCards).where((0, drizzle_orm_1.eq)(schema_1.knowledgeCards.key, key));
+        if (existing && (existing.participantId !== me.id || existing.chatId !== chat.id)) {
+            throw (0, errors_1.conflict)('key_taken', 'Эта запись запуска уже принадлежит другой карточке.');
+        }
+        const [row] = existing
+            ? await this.db.update(schema_1.knowledgeCards).set({ ...values, revision: (0, drizzle_orm_1.sql) `${schema_1.knowledgeCards.revision} + 1` })
+                .where((0, drizzle_orm_1.eq)(schema_1.knowledgeCards.id, existing.id)).returning()
+            : await this.db.insert(schema_1.knowledgeCards).values({ ...values, key, chatId: chat.id, participantId: me.id }).returning();
+        return { card: lessonApi(row, chat.slug), created: !existing };
+    }
+    /**
+     * Уроки, похожие на текст запроса. Ищется по всем чатам — урок обобщён и годится в
+     * другом проекте, — но свой проект выше. Совпадение по одному слову из многих — шум:
+     * нужно хотя бы два общих слова (или все, если в запросе одно).
+     */
+    async search(query, { chat, limit = 5, category } = {}) {
+        const words = await this.words(query);
+        if (words.length === 0)
+            return [];
+        const tsquery = words.map(w => `'${w.replace(/\\/g, '\\\\').replace(/'/g, "''")}'`).join(' | ');
+        const vector = (0, drizzle_orm_1.sql) `to_tsvector('russian', ${schema_1.knowledgeCards.search})`;
+        const wanted = (0, drizzle_orm_1.sql) `to_tsquery('simple', ${tsquery})`;
+        const common = (0, drizzle_orm_1.sql) `cardinality(array(select unnest(tsvector_to_array(${vector})) intersect select unnest(string_to_array(${words.join(' ')}, ' '))))`; // в лексемах пробелов нет
+        const ownChat = chat ? (0, drizzle_orm_1.sql) `case when ${schema_1.knowledgeCards.chatId} = ${chat.id} then 1.5 else 1 end` : (0, drizzle_orm_1.sql) `1`;
+        const rows = await this.db.select({ row: schema_1.knowledgeCards, chat: schema_1.chats.slug }).from(schema_1.knowledgeCards)
+            .innerJoin(schema_1.chats, (0, drizzle_orm_1.eq)(schema_1.chats.id, schema_1.knowledgeCards.chatId))
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.isNotNull)(schema_1.knowledgeCards.search), ofCategory(category), (0, drizzle_orm_1.sql) `${vector} @@ ${wanted}`, (0, drizzle_orm_1.sql) `${common} >= ${Math.min(2, words.length)}`))
+            .orderBy((0, drizzle_orm_1.sql) `ts_rank(${vector}, ${wanted}) * ${ownChat} desc`, (0, drizzle_orm_1.desc)(schema_1.knowledgeCards.id))
+            .limit(clamp(limit, 1, 20));
+        return rows.map(r => lessonApi(r.row, r.chat));
+    }
+    /** Последние уроки проекта — для выгрузки KNOWLEDGE.md и просмотра. */
+    async lessons(chat, { limit = 500, category } = {}) {
+        const rows = await this.db.select().from(schema_1.knowledgeCards)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.knowledgeCards.chatId, chat.id), (0, drizzle_orm_1.isNotNull)(schema_1.knowledgeCards.search), ofCategory(category)))
+            .orderBy((0, drizzle_orm_1.desc)(schema_1.knowledgeCards.id)).limit(limit);
+        return rows.map(r => lessonApi(r, chat.slug));
+    }
+    /**
+     * Заменить карточку целиком — правка владельцем машины (служебные пути): убрать из урока
+     * то, чему там не место. Ключ и автор остаются, ревизия растёт — правка уйдёт и сборщику.
+     */
+    async replace(id, input) {
+        const card = (0, validation_1.validate)(exports.cardSchema, input);
+        if (JSON.stringify(card).length > exports.MAX_CARD)
+            throw errors_1.ValidationFailed.field('card', 'Карточка слишком большая.');
+        const [row] = await this.db.update(schema_1.knowledgeCards)
+            .set({ card, format: card.format, search: searchText(card), revision: (0, drizzle_orm_1.sql) `${schema_1.knowledgeCards.revision} + 1` })
+            .where((0, drizzle_orm_1.eq)(schema_1.knowledgeCards.id, id)).returning();
+        if (!row)
+            throw (0, errors_1.notFound)();
+        const [chat] = await this.db.select({ slug: schema_1.chats.slug }).from(schema_1.chats).where((0, drizzle_orm_1.eq)(schema_1.chats.id, row.chatId));
+        return lessonApi(row, chat.slug);
+    }
+    /** Удалить карточку может только владелец: опыт команды — его данные. */
+    async remove(me, id) {
+        if (!(0, participants_service_1.isOwner)(me))
+            throw (0, errors_1.forbidden)('Удалять опыт может только владелец.');
+        const [row] = await this.db.delete(schema_1.knowledgeCards).where((0, drizzle_orm_1.eq)(schema_1.knowledgeCards.id, id)).returning({ id: schema_1.knowledgeCards.id });
+        if (!row)
+            throw (0, errors_1.notFound)();
+        return { deleted: row.id };
+    }
+    /** Слова запроса так, как их видит поиск: основы без окончаний, без служебных слов. */
+    async words(query) {
+        const text = query.replace(/@[\w-]+/g, ' ').replace(/https?:\/\/\S+/g, ' ').slice(0, 4000);
+        if (!text.trim())
+            return [];
+        const [{ words }] = await this.db.execute((0, drizzle_orm_1.sql) `select tsvector_to_array(to_tsvector('russian', ${text})) as words`)
+            .then(r => r.rows);
+        return (words ?? []).slice(0, MAX_QUERY_WORDS);
+    }
+};
+exports.KnowledgeService = KnowledgeService;
+exports.KnowledgeService = KnowledgeService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(database_module_1.DATABASE)),
+    __metadata("design:paramtypes", [Object])
+], KnowledgeService);
+function ofCategory(category) {
+    return category ? (0, drizzle_orm_1.sql) `${schema_1.knowledgeCards.card} -> 'problem' ->> 'category' = ${category}` : undefined;
+}
+/** Текст, по которому ищется урок: сам урок и стек. Без правила урока нет — и искать нечего. */
+function searchText(card) {
+    const { problem, solution } = card;
+    if (!problem?.symptom || !solution?.rule)
+        return null;
+    return [
+        problem.category, problem.area, problem.symptom, problem.root_cause,
+        solution.rule, solution.applies_when, ...solution.approach, ...stackNames(card.stack),
+    ].filter(Boolean).join('\n');
+}
+/** Имена технологий стека: «Node.js 22», «NestJS 11». */
+function stackNames(stack) {
+    const named = (list) => (Array.isArray(list) ? list : [])
+        .map(x => (typeof x === 'string' ? x : [x?.name, x?.version].filter(Boolean).join(' ')))
+        .filter(Boolean);
+    return [...named(stack.languages), ...named(stack.frameworks), ...named(stack.databases), ...named(stack.infra), ...named(stack.tests)];
+}
+/** Урок так, как его видят агенты и выгрузка: без счётчиков хода работы. */
+function lessonApi(row, chat) {
+    const card = row.card;
+    const process = card.process;
+    return {
+        id: row.id,
+        chat,
+        problem: card.problem ?? null,
+        solution: card.solution ?? null,
+        stack: stackNames(card.stack),
+        engine: process.engine ?? null,
+        at: (0, format_1.iso)(row.createdAt),
+    };
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, Number.isFinite(value) ? Math.trunc(value) : min));
+}

package/server/dist/src/local/docs-sync.service.js

@@ -0,0 +1,97 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocsSyncService = void 0;
+const common_1 = require("@nestjs/common");
+const drizzle_orm_1 = require("drizzle-orm");
+const zod_1 = require("zod");
+const errors_1 = require("../common/errors");
+const validation_1 = require("../common/validation");
+const chats_service_1 = require("../chats/chats.service");
+const database_module_1 = require("../db/database.module");
+const schema_1 = require("../db/schema");
+const decisions_service_1 = require("../decisions/decisions.service");
+const documents_service_1 = require("../documents/documents.service");
+const knowledge_service_1 = require("../knowledge/knowledge.service");
+const participants_service_1 = require("../participants/participants.service");
+const importSchema = zod_1.z.object({
+    chat: zod_1.z.string().nullish(),
+    documents: zod_1.z.array(zod_1.z.object({
+        slug: zod_1.z.string().max(200),
+        title: zod_1.z.string().max(300),
+        kind: zod_1.z.enum(documents_service_1.KINDS),
+        origin: zod_1.z.string().max(300),
+        body: zod_1.z.string(),
+    })),
+});
+/**
+ * Документы и решения ↔ репозитории. Файлы читает и пишет CLI на машине с репозиториями;
+ * сервер только отдаёт подтверждённое и принимает импортированное — к файловой системе
+ * чужих репозиториев он не прикасается.
+ */
+let DocsSyncService = class DocsSyncService {
+    db;
+    chats;
+    documents;
+    decisions;
+    knowledge;
+    constructor(db, chats, documents, decisions, knowledge) {
+        this.db = db;
+        this.chats = chats;
+        this.documents = documents;
+        this.decisions = decisions;
+        this.knowledge = knowledge;
+    }
+    /**
+     * Для выгрузки наружу уходит ТОЛЬКО current — то, что владелец подтвердил. Уроки агентов —
+     * для KNOWLEDGE.md: в них нет кода, только обобщённый опыт.
+     */
+    async exportData(chatSlug) {
+        const chat = await this.chats.resolve(chatSlug);
+        const current = await this.documents.list(chat, { status: 'current' });
+        const documents = [];
+        for (const d of current)
+            documents.push(await this.documents.read(chat, String(d.slug)));
+        return {
+            chat: { slug: chat.slug, name: chat.name, workdir: chat.workdir },
+            documents,
+            decisions: await this.decisions.list(chat),
+            knowledge: await this.knowledge.lessons(chat),
+        };
+    }
+    /**
+     * Импорт .md из репозиториев: приезжает черновиком — актуальность подтверждает человек,
+     * иначе протухшие аудиты снова станут неотличимы от живых.
+     */
+    async importDocuments(input) {
+        const data = (0, validation_1.validate)(importSchema, input);
+        const chat = await this.chats.resolve(data.chat ?? undefined);
+        const [owner] = await this.db.select().from(schema_1.participants).where((0, drizzle_orm_1.eq)(schema_1.participants.role, participants_service_1.ROLE_OWNER)).orderBy((0, drizzle_orm_1.asc)(schema_1.participants.id)).limit(1);
+        if (!owner)
+            throw errors_1.ValidationFailed.field('chat', 'Владельца ещё нет — сначала team-chat start.');
+        for (const d of data.documents) {
+            await this.documents.put(chat, owner, { ...d, status: 'draft', note: 'импорт из репозитория' });
+        }
+        return { chat: chat.slug, imported: data.documents.length };
+    }
+};
+exports.DocsSyncService = DocsSyncService;
+exports.DocsSyncService = DocsSyncService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(database_module_1.DATABASE)),
+    __metadata("design:paramtypes", [Object, chats_service_1.ChatsService,
+        documents_service_1.DocumentsService,
+        decisions_service_1.DecisionsService,
+        knowledge_service_1.KnowledgeService])
+], DocsSyncService);