# Portabilität: UNIVERSAL
# Zuletzt validiert: 2026-02-15 (Opus 4.6)
# Nächste Prüfung: 2026-05-15
# Ressourcen: [NPM Registry, GitHub Repos]

NPM PUBLISH - MCP Server Veröffentlichung
============================================

STAND: 2026-02-15

Workflow zum Veröffentlichen der BACH MCP Server auf NPM und GitHub.

PAKETE
------
  ellmos-filecommander-mcp    39 Tools, Filesystem/Prozesse/Sessions/i18n
  ellmos-codecommander-mcp    15 Tools, Code-Analyse/JSON/Encoding/i18n

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

NPM AUTHENTIFIZIERUNG
----------------------
  Methode: Granular Access Token mit "Bypass 2FA"
  Token-Name: bach-publisher 2
  Erstellt: 2026-02-15
  Läuft ab: 2026-05-16
  Gespeichert in: ~/.npmrc

  WICHTIG: Classic Automation Tokens funktionieren NICHT mehr (EOTP-Fehler).
  Nur Granular Access Tokens mit "Bypass 2FA" umgehen die OTP-Abfrage.

  Token erneuern (wenn abgelaufen):
    1. https://www.npmjs.com/settings/~/tokens -> "Generate New Token"
    2. "Granular Access Token" waehlen (NICHT Classic!)
    3. Permissions: Read and Write, alle Packages
    4. "Bypass 2FA" Checkbox aktivieren
    5. Token in ~/.npmrc eintragen:
       //registry.npmjs.org/:_authToken=<neuer-token>

NPM PUBLISH WORKFLOW
---------------------
  1. Token prüfen:
     npm whoami    -> muss "lukisch" ausgeben

  2. Build manuell ausführen (wegen & im Pfad KI&AI):
     node "<pfad>/node_modules/typescript/bin/tsc" --project "<pfad>/tsconfig.json"

  3. npm publish ausführen (kein OTP, kein Browser nötig):
     cd <projektverzeichnis>
     npm publish --ignore-scripts

BEKANNTE PROBLEME
------------------
  - & im Pfad "KI&AI" stört npm scripts (prepublishOnly)
    -> Workaround: --ignore-scripts (Build vorher manuell)
  - npm run build schlaegt fehl im Projektverzeichnis
    -> Workaround: tsc direkt über node aufrufen
  - Classic Automation Tokens loesen EOTP-Fehler aus
    -> Workaround: Granular Access Token mit "Bypass 2FA"

GITHUB WORKFLOW
----------------
  1. git add <dateien> && git commit -m "message"
  2. git tag vX.Y.Z
  3. git push origin master --tags

VERSION BUMP CHECKLISTE
------------------------
  [ ] package.json version
  [ ] src/index.ts version (server config)
  [ ] CHANGELOG.md neuer Eintrag
  [ ] README.md falls Features sich ändern
  [ ] Build testen
  [ ] Git commit + tag + push
  [ ] npm publish --ignore-scripts

SIEHE AUCH
----------
  docs/help/tools.txt         Tool-Übersicht
  docs/help/coding.txt        Coding-Standards
  skills/workflows/npm-mcp-publish.md  Ausführliches Protokoll
