@moabpro/recap-mcp 0.1.0 → 0.1.2

package/dist/auth.js

@@ -55,19 +55,19 @@ export class Authenticator {
     async getAccessToken() {
         const state = await this.store.load();
         if (!state)
-            throw new AuthRequiredError('Не авторизовано. Запустите инструмент login.');
+            throw new AuthRequiredError('Не авторизовано. Запустите инструмент moab_login.');
         if (state.tokens && state.tokens.expiresAt - this.now() > EXPIRY_SKEW_MS)
             return state.tokens.accessToken;
         if (state.tokens)
             return this.refreshOrThrow(state.tokens.refreshToken);
         if (state.pending)
             return this.completePendingOrThrow(state.pending);
-        throw new AuthRequiredError('Не авторизовано. Запустите инструмент login.');
+        throw new AuthRequiredError('Не авторизовано. Запустите инструмент moab_login.');
     }
     async invalidateAndRefresh() {
         const state = await this.store.load();
         if (!state?.tokens)
-            throw new AuthRequiredError('Не авторизовано. Запустите инструмент login.');
+            throw new AuthRequiredError('Не авторизовано. Запустите инструмент moab_login.');
         return this.refreshOrThrow(state.tokens.refreshToken);
     }
     async status() {
@@ -85,7 +85,7 @@ export class Authenticator {
         });
         if (!res.ok) {
             await this.store.clear();
-            throw new AuthRequiredError('Сессия истекла. Запустите инструмент login заново.');
+            throw new AuthRequiredError('Сессия истекла. Запустите инструмент moab_login заново.');
         }
         const b = (await res.json());
         const tokens = { accessToken: b.access_token, refreshToken: b.refresh_token, expiresAt: this.now() + b.expires_in * 1000 };
@@ -95,7 +95,7 @@ export class Authenticator {
     async completePendingOrThrow(pending) {
         if (this.now() > pending.deadline) {
             await this.store.clear();
-            throw new AuthRequiredError('Код подтверждения истёк. Запустите login заново.');
+            throw new AuthRequiredError('Код подтверждения истёк. Запустите moab_login заново.');
         }
         const res = await this.fetchFn(this.tokenUrl(), {
             method: 'POST', headers: { 'content-type': 'application/x-www-form-urlencoded' },
@@ -111,7 +111,7 @@ export class Authenticator {
         if (err.error === 'authorization_pending' || err.error === 'slow_down')
             throw new AuthPendingError('Вход ещё не подтверждён. Подтвердите в браузере и повторите запрос.');
         await this.store.clear();
-        throw new AuthRequiredError('Не удалось войти. Запустите инструмент login заново.');
+        throw new AuthRequiredError('Не удалось войти. Запустите инструмент moab_login заново.');
     }
 }
 /** preferred_username/email из payload JWT (без верификации — только для отображения). */

package/dist/errors.js

@@ -10,7 +10,7 @@ export class ApiError extends Error {
 /** Дружелюбный русский текст по HTTP-коду ответа /api/recaps. */
 export function ruRecapError(status, body) {
     switch (status) {
-        case 401: return '✗ Вход не принят или истёк. Выполни инструмент login (device-flow) и повтори.';
+        case 401: return '✗ Вход не принят или истёк. Выполни инструмент moab_login (device-flow) и повтори.';
         case 403: return '✗ Доступ запрещён: нужна портальная роль crew. Обратись к администратору портала.';
         case 409: return '⚠ Сервер счёл recap дубликатом (409). Если ты не отправлял его только что повторно — возможно ушло пустое тело; проверь дашборд. Памятка НЕ обновлена.';
         case 429: return '✗ Rate limit превышен, попробуй позже.';

package/dist/init.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, renameSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 function readJson(file) {
@@ -11,22 +11,86 @@ function readJson(file) {
         return {};
     }
 }
-/**
- * `recap-mcp init`: прописать MCP-сервер (~/.claude.json) и SessionStart-хук (~/.claude/settings.json).
- * Идемпотентно. Перед перезаписью ~/.claude.json делает бэкап (критичный файл, управляется Claude Code).
- */
+/** Удаляет из cfg.hooks все записи, ссылающиеся на старые recap-*.ps1 (legacy-плагин). Возвращает число удалённых. */
+function stripLegacyHooks(cfg) {
+    if (!cfg.hooks || typeof cfg.hooks !== 'object')
+        return 0;
+    const isLegacy = (c) => typeof c === 'string' && /recap-[a-z-]*\.ps1/i.test(c);
+    let removed = 0;
+    for (const ev of Object.keys(cfg.hooks)) {
+        let arr = cfg.hooks[ev];
+        if (!Array.isArray(arr))
+            continue;
+        for (const g of arr)
+            if (g && Array.isArray(g.hooks)) {
+                const before = g.hooks.length;
+                g.hooks = g.hooks.filter((h) => !isLegacy(h && h.command));
+                removed += before - g.hooks.length;
+            }
+        arr = arr.filter((g) => {
+            if (g && Array.isArray(g.hooks))
+                return g.hooks.length > 0;
+            if (g && isLegacy(g.command)) {
+                removed++;
+                return false;
+            }
+            return true;
+        });
+        if (arr.length)
+            cfg.hooks[ev] = arr;
+        else
+            delete cfg.hooks[ev];
+    }
+    return removed;
+}
+const CMD_MOABRECAP = `---
+description: Сделать recap текущей работы и отправить (MoabRecap)
+---
+Сделай recap текущей работы и отправь его инструментом send_recap (MCP-сервер moab-recap).
+
+Если send_recap (или list_projects) ответит «выполни moab_login» — сначала вызови инструмент moab_login, покажи пользователю ссылку и код, дождись подтверждения в браузере, затем повтори.
+
+ОКНО: описывай только то, что сделано С МОМЕНТА ПРОШЛОГО РЕКАПА (инструмент сам посчитает окно по git и времени).
+
+SUMMARY (поле summary) — для РУКОВОДИТЕЛЯ, НЕ для разработчика: 3-5 предложений по-русски, жёсткий потолок 1800 символов, простым языком без техники (бизнес-результат, не «refactor/endpoint/Mongo»), и ОБЯЗАТЕЛЬНО 1-2 предложения про «обратную сторону» (что не успели / где застряли / какой долг вскрылся); если реально гладко — «Открытых хвостов в этом окне нет.»
+
+TAGS (1-3 из): feature, bugfix, refactor, docs, tests, setup, infra, research, review, planning, other.
+COMPLEXITY (1-5): 1=опечатка / 2=мелкий CRUD / 3=многокомпонентная фича или нетривиальный дебаг / 4=многофайловый рефактор или сложная гонка / 5=архитектура.
+EFFORT (1-5): 1<15мин / 2~30мин / 3=1-2ч / 4=полдня / 5=день+.
+
+ПРОВЕРКА «маловато»: если complexity ≤ 3 — сначала спроси пользователя через AskUserQuestion «Маловато изменений для рекапа. Может, ещё поработаем?» (варианты: «Да, поработаем» / «Нет, сделать рекап сейчас»). Если «Да» — НЕ вызывай send_recap, заверши строкой «✓ Ок, продолжаем — recap не отправлен.» Если complexity ≥ 4 — сразу вызывай send_recap.
+
+Если пользователь дал аргумент-подсказку ($ARGUMENTS) — учти её и передай как userHint.
+`;
+const CMD_SWITCH = `---
+description: Выбрать/сменить проект, закреплённый за сессией recap (MoabRecap)
+---
+Смени проект, закреплённый за этой сессией (MCP-сервер moab-recap).
+
+1. Если у сессии уже закреплён проект и это не research — сначала предложи пользователю сделать /moabrecap по текущему проекту (через AskUserQuestion). Согласен — выполни /moabrecap, потом продолжай.
+2. Если дан аргумент-имя ($ARGUMENTS) — используй его напрямую как имя проекта. Иначе вызови инструмент list_projects (если он ответит «выполни moab_login» — сначала moab_login: покажи ссылку+код, дождись подтверждения, повтори list_projects), покажи нумерованный список (плюс «0. Research-сессия без проекта» и «N. Создать новый проект»), жди цифру.
+3. Сопоставь цифру: 0 → pin_project с "__research__"; существующий → pin_project с этим именем; «создать новый» → спроси имя и pin_project с ним.
+4. После закрепления подтверди и покажи готовую строку «/rename <имя>» (её пользователь скопирует сам).
+`;
+const CMD_LOGIN = `---
+description: Войти в MoabRecap (device-flow, портальная роль crew)
+---
+Вызови инструмент moab_login (MCP-сервер moab-recap). Он вернёт ссылку и код подтверждения — покажи их пользователю и попроси открыть ссылку в браузере и подтвердить вход (нужна портальная роль crew). После подтверждения можешь проверить moab_auth_status.
+`;
 export async function runInit() {
     const home = homedir();
-    const claudeJson = join(home, '.claude.json'); // user-scope MCP servers — ЗДЕСЬ
-    const settingsJson = join(home, '.claude', 'settings.json'); // hooks — ЗДЕСЬ
+    const claudeJson = join(home, '.claude.json');
+    const settingsJson = join(home, '.claude', 'settings.json');
+    const commandsDir = join(home, '.claude', 'commands');
     mkdirSync(join(home, '.claude'), { recursive: true });
-    // 1) MCP-сервер в ~/.claude.json (type:stdio; литеральные дефолты — без ${...}-интерполяции)
+    mkdirSync(commandsDir, { recursive: true });
+    // 1) MCP-сервер в ~/.claude.json (литеральные non-secret env)
     const cj = readJson(claudeJson);
     if (existsSync(claudeJson)) {
         try {
             copyFileSync(claudeJson, claudeJson + '.recap-bak');
         }
-        catch { /* бэкап best-effort */ }
+        catch { /* ignore */ }
     }
     cj.mcpServers ??= {};
     cj.mcpServers['moab-recap'] = {
@@ -40,8 +104,15 @@ export async function runInit() {
         },
     };
     writeFileSync(claudeJson, JSON.stringify(cj, null, 2));
-    // 2) SessionStart-хук в ~/.claude/settings.json (command → npx recap-mcp session-start)
+    // 2) settings.json: вычистить legacy recap-*.ps1 хуки + добавить наш SessionStart-хук
     const sj = readJson(settingsJson);
+    if (existsSync(settingsJson)) {
+        try {
+            copyFileSync(settingsJson, settingsJson + '.recap-bak');
+        }
+        catch { /* ignore */ }
+    }
+    const removedHooks = stripLegacyHooks(sj);
     sj.hooks ??= {};
     sj.hooks.SessionStart ??= [];
     const already = JSON.stringify(sj.hooks.SessionStart).includes('recap-mcp');
@@ -52,9 +123,28 @@ export async function runInit() {
         });
     }
     writeFileSync(settingsJson, JSON.stringify(sj, null, 2));
-    process.stdout.write('✓ recap-mcp прописан:\n' +
-        `  • MCP-сервер       → ${claudeJson} (mcpServers.moab-recap, type=stdio)\n` +
-        `  • SessionStart хук → ${settingsJson} (hooks.SessionStart)\n` +
-        'После перезапуска Claude Code выполните инструмент login (device-flow) — нужна портальная роль crew.\n' +
-        'Перезапусти Claude Code.\n');
+    // 3) команды: отодвинуть старые одноимённые (legacy-плагин) в бэкап + записать чистые
+    const bakDir = join(commandsDir, '_pre-recap-mcp-bak');
+    let movedCmds = 0;
+    for (const legacy of ['moabrecap.md', 'switch-project.md', 'moabupdate.md']) {
+        const p = join(commandsDir, legacy);
+        if (existsSync(p)) {
+            mkdirSync(bakDir, { recursive: true });
+            try {
+                renameSync(p, join(bakDir, legacy));
+                movedCmds++;
+            }
+            catch { /* ignore */ }
+        }
+    }
+    writeFileSync(join(commandsDir, 'moabrecap.md'), CMD_MOABRECAP);
+    writeFileSync(join(commandsDir, 'switch-project.md'), CMD_SWITCH);
+    writeFileSync(join(commandsDir, 'moab-login.md'), CMD_LOGIN);
+    process.stdout.write('✓ recap-mcp установлен (глобально, все сессии):\n' +
+        `  • MCP-сервер        → ${claudeJson} (mcpServers.moab-recap)\n` +
+        `  • SessionStart хук  → ${settingsJson}\n` +
+        `  • команды           → ${commandsDir}/ (/moabrecap, /switch-project, /moab-login)\n` +
+        (removedHooks ? `  • вычищено старых recap-хуков: ${removedHooks}\n` : '') +
+        (movedCmds ? `  • старые команды отодвинуты → ${bakDir}/ (${movedCmds})\n` : '') +
+        'Перезапусти Claude Code. Первый /switch-project (или /moabrecap) попросит выполнить вход — нужна портальная роль crew.\n');
 }

package/dist/server.js

@@ -2,12 +2,10 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { RecapApi } from './api-client.js';
 import { FileTokenStore, Authenticator } from './auth.js';
 import { registerTools } from './tools/index.js';
-import { registerPrompts } from './prompts/index.js';
 export function createServer(deps) {
-    const server = new McpServer({ name: 'moab-recap', version: '0.1.0' });
+    const server = new McpServer({ name: 'moab-recap', version: '0.1.2' });
     const auth = new Authenticator({ authority: deps.config.authority, client: deps.config.client }, new FileTokenStore(deps.config.configDir));
     const api = new RecapApi(deps.config, auth);
     registerTools(server, { config: deps.config, api, auth });
-    registerPrompts(server);
     return server;
 }

package/dist/session-start.js

@@ -37,8 +37,12 @@ export async function runSessionStart() {
         ctx = `Проект «${sess.project}» закреплён за этой сессией (рекапы). /moabrecap — сделать recap, /switch-project — сменить.`;
     }
     else {
-        ctx = 'Прежде чем работать — закрепи проект для рекапов: вызови команду /switch-project '
-            + '(она покажет список проектов и закрепит выбор за сессией). Без проекта /moabrecap не отправится.';
+        ctx = 'ВАЖНО: эта сессия НЕ закреплена за проектом для рекапов (MoabRecap). '
+            + 'НЕ начинай выполнять задачи пользователя, пока проект не закреплён. '
+            + 'Сначала вызови команду /switch-project — она (при необходимости попросит выполнить инструмент moab_login) '
+            + 'покажет список проектов и закрепит выбор за сессией: существующий проект, либо «создать новый», '
+            + 'либо research-сессия (без рекапов). Только после закрепления переходи к задаче пользователя. '
+            + 'Без закреплённого проекта /moabrecap не отправится.';
     }
     process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: 'SessionStart', additionalContext: ctx } }));
 }

package/dist/tools/auth-tools.js

@@ -1,7 +1,7 @@
 import { run, ok } from './index.js';
 export function registerAuthTools(server, deps) {
-    server.registerTool('login', {
-        title: 'Войти',
+    server.registerTool('moab_login', {
+        title: 'Войти (MoabRecap)',
         description: 'Вход в MoabRecap через auth.moab.tools (device flow). Возвращает ссылку и код для подтверждения в браузере. Нужна портальная роль crew.',
         inputSchema: {},
     }, async () => run(async () => {
@@ -11,20 +11,20 @@ export function registerAuthTools(server, deps) {
             dc.verification_uri_complete,
             `Код подтверждения: ${dc.user_code}`,
             '',
-            'После подтверждения просто повторите нужную операцию (/moabrecap или /switch-project) — вход применится автоматически.',
+            'После подтверждения повторите операцию (/moabrecap или /switch-project) — вход применится автоматически.',
         ].join('\n');
     }));
-    server.registerTool('auth_status', {
-        title: 'Статус входа',
+    server.registerTool('moab_auth_status', {
+        title: 'Статус входа (MoabRecap)',
         description: 'Показать, выполнен ли вход и под каким пользователем.',
         inputSchema: {},
         annotations: { readOnlyHint: true },
     }, async () => run(async () => {
         const s = await deps.auth.status();
-        return s.loggedIn ? `Вы вошли как ${s.username ?? '(неизвестно)'}.` : 'Вход не выполнен. Запустите инструмент login.';
+        return s.loggedIn ? `Вы вошли как ${s.username ?? '(неизвестно)'}.` : 'Вход не выполнен. Запустите инструмент moab_login.';
     }));
-    server.registerTool('auth_logout', {
-        title: 'Выйти',
+    server.registerTool('moab_auth_logout', {
+        title: 'Выйти (MoabRecap)',
         description: 'Удалить сохранённые токены входа.',
         inputSchema: {},
     }, async () => { await deps.auth.logout(); return ok('Вы вышли. Сохранённые токены удалены.'); });

package/dist/tools/send-recap.js

@@ -31,7 +31,7 @@ export function registerSendRecap(server, deps) {
             throw new Error('Сессия в research-режиме — recap не отправляется. /switch-project чтобы выбрать проект.');
         if (!sess.project)
             throw new Error('Проект для сессии не закреплён. Вызови /switch-project.');
-        await deps.auth.getAccessToken(); // бросит AuthRequiredError → run() покажет «запустите login»
+        await deps.auth.getAccessToken(); // бросит AuthRequiredError → run() покажет «запустите moab_login»
         const meta = collectMeta(deps.config, cwd);
         const tPath = latestTranscriptPath();
         const transcript = readTranscript(tPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moabpro/recap-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for MoabRecap — manual session recaps with window-since-last-recap.",
   "type": "module",
   "bin": { "recap-mcp": "dist/index.js" },