# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [Реестр NPM, репозитории GitHub]

NPM PUBLISH — публикация сервера MCP
--------------------------------------------

ДАТА: 15 февраля 2026 г.

Рабочий процесс публикации сервера BACH MCP в NPM и GitHub.

ПАКЕТЫ
------
  ellmos-filecommander-mcp 39 инструментов, файловая система/процессы/сессии/i18n
  ellmos-codecommander-mcp 15 инструментов, анализ кода/JSON/кодирование/i18n

GITHUB REPOS
-------------
  https://github.com/lukisch/ellmos-filecommander-mcp
  https://github.com/lukisch/ellmos-codecommander-mcp

АУТЕНТИФИКАЦИЯ NPM
----------------------
  Метод: детальный токен доступа с «обходом 2FA».
  Имя токена: bach-publisher 2
  Создано: 15 февраля 2026 г.
  Срок действия истекает: 16 мая 2026 г.
  Хранится в: ~/.npmrc

  ВАЖНО: Классические токены автоматизации больше не работают (ошибка EOTP).
  Только токены детального доступа с «Обходом 2FA» обходят запрос OTP.

  Обновить токен (если срок его действия истек):
    1. https://www.npmjs.com/settings/~/tokens -> «Создать новый токен»
    2. Выберите «Токен детального доступа» (НЕ классический!)
    3. Разрешения: чтение и запись, все пакеты.
    4. Активируйте флажок «Обход 2FA».
    5. Введите токены в ~/.npmrc:
       //registry.npmjs.org/:_authToken=<new-token>

РАБОЧИЙ ПРОЦЕСС ПУБЛИКАЦИИ NPM
---------------------
  1. Проверьте токен:
     npm whoami -> должен вывести «lukisch»

  2. Запускаем сборку вручную (из-за & в пути KI&AI):
     узел "<путь>/node_modules/typescript/bin/tsc" --project "<путь>/tsconfig.json"

  3. Запустите npmPublish (без OTP и без браузера):
     cd <каталог проекта>
     npmPublish --ignore-scripts

ИЗВЕСТНЫЕ ПРОБЛЕМЫ
------------------
  - & в пути "KI&AI" ломает скрипты npm (prepublishOnly)
    -> Обходной путь: --ignore-scripts (предварительно создайте вручную)
  - сбой сборки npm run в каталоге проекта
    -> Обходной путь: вызвать tsc напрямую через узел
  - Классические токены автоматизации вызывают ошибки EOTP.
    -> Обходной путь: детальный токен доступа с «обходом 2FA»

РАБОЧЕЕ ПРОЦЕСС GITHUB
----------------
  1. git add <файлы> && git commit -m "сообщение"
  2. git-тег vX.Y.Z
  3. git push origin master --tags

ПРОВЕРОЧНЫЙ СПИСОК ВЕРСИИ
------------------------
  [ ] версия package.json
  [ ] версия src/index.ts (конфигурация сервера)
  [ ] CHANGELOG.md новая запись
  [ ] README.md, если функции изменятся
  [ ] Тестовая сборка
  [ ] Git коммит + тег + push
  [ ] npmPublish --ignore-scripts

СМОТРИ ТАКЖЕ
----------
  docs/help/tools.txt Обзор инструмента
  docs/help/coding.txt Стандарты кодирования
  навыки/рабочие процессы/npm-mcp-publish.md Подробный журнал
