layoutbridge-spm 0.0.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,171 @@
+# Changelog – LayoutBridge for Adobe InDesign® (package `layoutbridge-spm`)
+
+All notable changes to the package are recorded in this file. Format based
+on “Keep a Changelog” (https://keepachangelog.com/en/1.1.0/), version
+numbers follow Semantic Versioning (https://semver.org/).
+
+One release a month with a catalogue of new features; bug fixes are
+implemented as quickly as possible, independently of that release cycle.
+Tool names, parameters and return fields remain stable within a major
+version; additions are additive (new tools, new optional parameters, new
+fields). Renames and changed defaults belong in a new major version with
+its own entry.
+
+This file is part of the npm package and the MCPB bundle; the customer
+version on the product page is derived from it.
+
+Adobe and InDesign are either registered trademarks or trademarks of Adobe
+in the United States and/or other countries.
+
+## [Unreleased]
+
+No changes yet.
+
+## [1.0.0] - 2026-09-23
+
+First release. State of the product:
+
+- 110 tools for Adobe® InDesign® via MCP (stdio): documents and pages,
+  layout grid, baseline grid and guides, layers, frames, images and links,
+  text and styles, tables, swatches and gradients, design, text variables
+  and sections, taking over third-party documents, typography check,
+  preflight, packaging, PDF and image export.
+- Platforms: macOS (Apple Events) and Windows 10/11 x64 (COM,
+  PowerShell 5.1); Node.js 20 or newer.
+- Two ways to install: the installation package for Claude Desktop
+  (`layoutbridge-spm-1.0.0.mcpb`, runs with the Node.js built into Claude
+  Desktop) and the npm package `layoutbridge-spm` (`--setup`).
+- Licence key per workstation with online check, 24-hour recheck, 14 days
+  of grace without network and release when changing computers
+  (`npx layoutbridge-spm --deactivate`).
+- Log per call with data minimisation: no document text, no user names in
+  paths, random workstation identifier.
+
+Changes made while preparing the first release, for reference:
+
+### Added
+
+- The server checks the Node.js version at start. If it is older than 20,
+  the start ends with a message in English and German that names the
+  version found and the version required and refers to the installation
+  guide (exit code 1). New entry point `dist/src/mcp/start.cjs` for
+  `npx layoutbridge-spm` and the MCPB bundle; starting
+  `dist/src/mcp/server.js` directly remains possible.
+- Every message of the error kind `license` names the support address
+  kontakt@mcp-interfaces.com in plain text; `error.details` additionally
+  carries `support`, `license_terms` and `license_terms_de` (additive).
+- The server's start line and the log's start line name the address of
+  the licence terms and the support address.
+- `CHANGELOG.md` (this file), `THIRD-PARTY-NOTICES`, `server.json`
+  (MCP Registry) and `manifest.json` (MCPB bundle) in preparation for the
+  first release; README sections License terms, Privacy Policy, Support
+  and Third-party notices.
+- Setup command `npx layoutbridge-spm --setup`: adds the server to the
+  Claude Desktop configuration (`mcpServers.layoutbridge-spm`, command
+  `npx -y layoutbridge-spm`) and stores the licence key in `license.key`
+  in the default location. Shows the file path and the new entry and asks
+  before writing; creates a backup of the configuration file first; leaves
+  all other entries byte-for-byte unchanged; stops on invalid JSON with
+  line and column; `--dry-run` writes nothing; stops without an
+  interactive terminal. No network, no administrator rights; not a tool
+  in the catalogue. Options `--license-key-file <path>` and `--client
+  claude-desktop`. Entering the configuration by hand remains documented.
+- German README as `README.de.md` in the package and the bundle; the
+  English `README.md` is the version shown by npm and directories.
+- New tool `position_image_in_frame`: moves the graphic inside a frame
+  without scaling it – `align` to one of nine reference points of the
+  frame and/or `offset_mm` {x, y}; the frame stays unchanged.
+- New tool `duplicate_parent_page`: duplicates a master spread with all
+  its pages and objects (`source_name`, optional `base_name`,
+  `name_prefix`, `keep_view`).
+- `move_pages`: optional `keep_spreads` rebuilds the affected spreads as
+  pairs after moving; InDesign's limit of 10 pages per spread is checked
+  before anything moves (`invalid_state`, `details.code`
+  `spread_page_limit`); a spread with more than two pages is a warning
+  that shows the new spread division. New return fields `keep_spreads` and
+  `spreads_rebuilt`.
+- `delete_page`: objects on the pasteboard of a spread that disappears
+  with the page are listed before deleting (id, type, link) in
+  `pasteboard_items`; optional `on_pasteboard_items` `warn` (default),
+  `abort` (`invalid_state`, `details.code` `pasteboard_items_present`) or
+  `move` together with `pasteboard_target_page_id`. New return fields
+  `on_pasteboard_items`, `pasteboard_items`, `pasteboard_moved_ids` and
+  `pasteboard_lost_ids`. A loss is predicted only when the page is the
+  only page of its spread; when InDesign regroups the spreads, objects on
+  the pasteboard move with their spread and are reported in the new return
+  field `pasteboard_relocated` (object, pages of the spread before and
+  after, position) together with a warning.
+- `move_frame_to_page`: optional `pasteboard` {side, gap_mm, y_mm} puts
+  the object on the pasteboard beside the spread of the target page. New
+  return fields `on_pasteboard` and `pasteboard_side`.
+- `create_parent_page`: optional `page_count` (1–10, also in single-sided
+  documents) and `based_on`. New return fields `page_count` and
+  `based_on`.
+- `set_frame_inset`: optional `vertical_justification` (top, center,
+  bottom, justify); `inset_mm` may be omitted when
+  `vertical_justification` is given. New return field
+  `vertical_justification`.
+- `set_text_in_range`: optional `keep_format_of` (`start` default,
+  `before`, `none`). New return field `keep_format_of`.
+
+### Changed
+
+- `LICENSE` rewritten: use is permitted only with a valid licence key and
+  only under the licence terms (links in German and English); contact
+  kontakt@mcp-interfaces.com. The licence field in `package.json` is now
+  `SEE LICENSE IN LICENSE`.
+- The support address in all messages, start lines, README, `package.json`
+  (`bugs`) and `manifest.json` (`support`) is now
+  kontakt@mcp-interfaces.com (the previous address remains reachable).
+- `author` in `package.json` and `manifest.json` is now “MCP Interfaces”.
+- `README.md` and this changelog are now in English.
+- Package description and README use the product name “LayoutBridge for
+  Adobe InDesign®”; the package name remains `layoutbridge-spm`.
+- `README.md` and `README.de.md` are now customer documentation:
+  requirements (Node.js version 20 or newer only for the npm package and
+  other MCP clients; the installation package runs with the Node.js built
+  into Claude Desktop), installation with the installation package
+  (switch the extension on after installing) or with npm (`--setup`, or
+  by hand with `"command": "npx"`), licence key, changing computers,
+  server configuration, log, licence terms, privacy, support.
+- The licence check uses the payment service Polar (`api.polar.sh`).
+  `manifest.json` (`privacy_policies`) and the README name Polar's privacy
+  policy (https://polar.sh/legal/privacy). When changing computers, an
+  activation can also be released in Polar's customer portal.
+- The licence gate is always active: without a valid licence key every
+  tool answers with the error kind `license`. The former development
+  switch `LAYOUTBRIDGE_SPM_LICENSE_ENFORCE` no longer exists and is
+  ignored if still set; the start line reads `license: enforced, …`.
+- Package contents limited to `dist/src`, `indesign/`, `rules/`, README
+  (English and German), LICENSE, THIRD-PARTY-NOTICES, CHANGELOG and
+  `package.json` (no tests, no development documents in the package).
+
+### Fixed
+
+- `move_pages` with `keep_spreads`: the rebuilt spreads were not facing
+  pairs – every page of a new spread stood on the right-hand side. The
+  left page of each pair is now placed before the spine and the right
+  page after it; afterwards every page is checked against its expected
+  side, and a page on the wrong side is a warning.
+- `move_pages` with `keep_spreads`: moving a page back and forth could
+  abort with a script error (“the object no longer exists”) after the
+  pages had already been moved, or report that the spreads could not be
+  rebuilt. Pages are now looked up afresh before every step; if a step of
+  rebuilding fails, the pages stay moved and the call ends with a warning.
+- `set_text_in_range`: text replacing a range at the start of a paragraph
+  took the formatting of the previous paragraph instead of the first
+  replaced character. It now keeps the formatting of the first replaced
+  character, as documented; `keep_format_of` `before` restores the former
+  behaviour. With `start`, the formatting of the first replaced character
+  now applies only up to the first new paragraph mark; every further new
+  paragraph takes the formatting of the replaced paragraph at the same
+  position (or of the last replaced paragraph), including its paragraph
+  style. When the range begins with a paragraph mark, the new text
+  continues that paragraph with its formatting.
+- The MCPB bundle did not start in Claude Desktop when Claude Desktop uses
+  its built-in Node.js: the entry point `start.cjs` only started the
+  server when it was the main module, but Claude Desktop loads the entry
+  point with `import()`. The request `initialize` stayed unanswered until
+  Claude Desktop gave up ("Request timed out"). The entry point now also
+  starts when the process arguments name it, however it is loaded; the
+  Node.js version check runs on this path as well.

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2026 SP Medienservice, Inhaber Sascha Piprek
+Alle Rechte vorbehalten. / All rights reserved.
+
+Diese Software und die zugehörige Dokumentation sind
+urheberrechtlich geschützt. Die Nutzung ist nur mit einem
+gültigen Lizenzschlüssel und nur nach den Lizenzbedingungen
+gestattet:
+https://mcp-schnittstellen.de/layoutbridge/lizenzbedingungen.html
+Darüber hinaus wird kein Nutzungsrecht eingeräumt.
+Vervielfältigung, Verbreitung, Bearbeitung, Weitergabe und
+öffentliche Zugänglichmachung – ganz oder in Teilen – bedürfen
+der vorherigen schriftlichen Zustimmung des Rechteinhabers,
+soweit die Lizenzbedingungen sie nicht erlauben.
+
+This software and its documentation are protected by
+copyright. Use is permitted only with a valid licence key and
+only under the licence terms:
+https://mcp-interfaces.com/layoutbridge/license.html
+No other rights of use are granted. Reproduction,
+distribution, modification, transfer and making available to
+the public – in whole or in part – require the prior written
+consent of the rights holder, except as permitted by the
+licence terms.
+
+Drittsoftware / Third-party software: THIRD-PARTY-NOTICES.md
+Kontakt / Contact: kontakt@mcp-interfaces.com

package/README.de.md

@@ -0,0 +1,318 @@
+# LayoutBridge for Adobe InDesign®
+
+English version: [README.md](README.md)
+
+**LayoutBridge for Adobe InDesign®** – MCP-Server für Adobe® InDesign®
+(npm-Paket `layoutbridge-spm`) von MCP Interfaces. Er stellt Satzarbeit in
+Adobe InDesign als Werkzeuge bereit, die jede MCP-fähige KI aufrufen kann:
+Dokumente und Seiten, Satzspiegel und Hilfslinien, Rahmen, Bilder und
+Verknüpfungen, Text, Formate, Tabellen, Farbfelder, Typografieprüfung,
+Preflight und Export.
+
+Produktseite: https://mcp-schnittstellen.de/layoutbridge/ (englisch:
+https://mcp-interfaces.com/layoutbridge/).
+Ausführliche Schritt-für-Schritt-Anleitung:
+https://mcp-schnittstellen.de/layoutbridge/installation.html (englisch:
+https://mcp-interfaces.com/layoutbridge/installation.html).
+
+Adobe and InDesign are either registered trademarks or trademarks of Adobe in
+the United States and/or other countries.
+
+## Voraussetzungen
+
+- Adobe® InDesign®, installiert und gestartet – Mac oder Windows (Windows
+  10/11 x64; geprüft mit InDesign® 21.5.1.73 auf Windows 11)
+- Windows: Windows PowerShell 5.1 (`powershell.exe`, in Windows enthalten)
+- Ihr Lizenzschlüssel aus der Quittungsmail des Kaufs – ein Schlüssel je
+  Arbeitsplatz
+- Eine Netzverbindung für die Lizenzprüfung beim ersten Aufruf
+- **Node.js ab Version 20 – nur für das npm-Paket** (Eintrag in der
+  Konfigurationsdatei, `--setup`, `--deactivate`) **und für andere
+  MCP-Clients.** Mit dem Installationspaket (`.mcpb`) ist keine eigene
+  Node.js-Installation nötig – Claude Desktop bringt Node.js mit (Schalter
+  „Use built-in Node.js for MCP“ unter „Erweiterte Einstellungen“, ab Werk
+  eingeschaltet).
+
+## Installation in Claude Desktop
+
+Es gibt zwei Wege. Weg A ist der kürzere; Weg B ist derselbe Eintrag, den
+auch andere MCP-Clients bekommen. Die oben verlinkte Anleitung zeigt jeden
+Schritt mit den Einzelheiten für Mac und Windows.
+
+**Weg A – Installationspaket (Bundle-Datei `.mcpb`)**
+
+1. Laden Sie die Datei `layoutbridge-spm-<Version>.mcpb` von der
+   Produktseite herunter.
+2. Öffnen Sie in Claude Desktop Einstellungen › Desktop-App › Erweiterungen
+   und ziehen Sie die Datei in dieses Fenster – dort steht „Ziehe .MCPB-
+   oder .DXT-Dateien hier her, um sie zu installieren“. Auf dem Mac können
+   Sie die Datei stattdessen per Doppelklick öffnen. Unter Windows öffnet
+   der Doppelklick Claude Desktop nicht – Windows fragt nach einem
+   Programm; ziehen Sie die Datei dort ins Fenster oder wählen Sie unter
+   „Erweiterte Einstellungen“ die Schaltfläche zum Installieren einer
+   Erweiterung (englische Oberfläche: „Advanced settings“ › „Install
+   extension“) und dann die Datei. Bestätigen Sie den Installationsdialog
+   mit „Installieren“.
+3. Tragen Sie Ihren Lizenzschlüssel in das Feld „Licence key“ ein und
+   klicken Sie auf „Speichern“. Claude Desktop speichert den Schlüssel auf
+   Ihrem Rechner.
+4. **Schalten Sie die Erweiterung ein.** Nach der Installation steht
+   „LayoutBridge for Adobe InDesign®“ unter Einstellungen › Erweiterungen
+   auf „Deaktiviert“. Stellen Sie den Schalter auf „Aktiviert“ – sonst
+   erscheinen keine Werkzeuge.
+
+**Weg B – npm-Paket (Node.js ab Version 20)**
+
+Einrichtungsbefehl – im Terminal (Mac) bzw. in der PowerShell (Windows)
+aufrufen:
+
+```
+npx layoutbridge-spm --setup
+```
+
+Der Befehl trägt den Server in die Konfigurationsdatei von Claude Desktop
+ein und legt den Lizenzschlüssel am Vorgabeort ab (siehe
+„Lizenzschlüssel“). Er läuft nur, wenn Sie ihn aufrufen. Vor jeder Änderung
+zeigt er den vollen Pfad der Datei und den neuen Eintrag im Wortlaut und
+fragt nach (`y` für ja, `n` für nein). Vor dem Schreiben legt er eine
+Sicherung `claude_desktop_config.json.bak-JJJJ-MM-TT_HHMM` im selben Ordner
+an; geändert wird nur der Eintrag `layoutbridge-spm` unter `mcpServers`,
+alle anderen Einträge bleiben unverändert. Ist die Datei kein gültiges
+JSON, bricht er ab und nennt Zeile und Spalte. Den Lizenzschlüssel fragt er
+verdeckt ab und schreibt ihn nur nach `license.key`. Keine
+Administratorrechte, keine Netzverbindung.
+
+- `--dry-run` zeigt dasselbe und schreibt nichts.
+- `--license-key-file <Pfad>` liest den Schlüssel aus einer Datei, statt
+  ihn abzufragen.
+
+**Von Hand:** Öffnen Sie die Konfigurationsdatei von Claude Desktop in
+einem Texteditor – Mac `~/Library/Application Support/Claude/claude_desktop_config.json`,
+Windows `%APPDATA%\Claude\claude_desktop_config.json` (einfacher:
+Einstellungen › Desktop-App › Entwickler › „Konfiguration bearbeiten“
+öffnet den Ordner mit der Datei). Ist die Datei leer oder noch nicht
+vorhanden, hat sie genau diesen Inhalt:
+
+```json
+{
+  "mcpServers": {
+    "layoutbridge-spm": {
+      "command": "npx",
+      "args": ["-y", "layoutbridge-spm"]
+    }
+  }
+}
+```
+
+Enthält die Datei bereits andere Server unter `"mcpServers"`, fügen Sie nur
+den Block `"layoutbridge-spm": { … }` dort ein – mit einem Komma zwischen
+den Einträgen – und lassen Sie alles andere unverändert. Legen Sie dann den
+Lizenzschlüssel ab (siehe „Lizenzschlüssel“). Beim ersten Start lädt `npx`
+das Paket `layoutbridge-spm` von der npm-Registry; danach startet es aus
+dem lokalen Speicher.
+
+**Danach:** Beenden Sie Claude Desktop vollständig – auf dem Mac mit ⌘ + Q,
+unter Windows über „Beenden“ im Menü der Anwendung; das Fenster zu
+schließen genügt nicht – und starten Sie es neu. Starten Sie Adobe®
+InDesign® und fragen Sie in Claude Desktop: „Welche InDesign®-Version
+läuft?“ Claude ruft das Werkzeug `get_app_version` auf und nennt die
+Version. Die Werkzeuge erscheinen auf Weg A unter dem Namen der Erweiterung
+„LayoutBridge for Adobe InDesign®“, auf Weg B mit dem Präfix
+`layoutbridge-spm:`.
+
+## Andere MCP-Clients
+
+Andere MCP-Clients (Claude Code, Cursor, GitHub Copilot u. a.) tragen
+denselben Server nach ihrer eigenen Dokumentation ein. Der Befehl ist
+überall
+
+```
+npx -y layoutbridge-spm
+```
+
+und setzt Node.js ab Version 20 voraus. Den Lizenzschlüssel findet der
+Server an denselben Orten wie unter „Lizenzschlüssel“ beschrieben.
+
+## Lizenzschlüssel
+
+Der Schlüssel steht in der Quittungsmail des Kaufs und gilt für genau einen
+Arbeitsplatz; mehrere Arbeitsplätze brauchen mehrere Schlüssel.
+
+**Wo LayoutBridge den Schlüssel sucht, in dieser Reihenfolge:**
+
+1. die Umgebungsvariable `LAYOUTBRIDGE_SPM_LICENSE_KEY` – das
+   Installationspaket setzt sie aus dem Feld „Licence key“; auf Weg B kann
+   sie als `"env": { "LAYOUTBRIDGE_SPM_LICENSE_KEY": "IHR-LIZENZSCHLÜSSEL" }`
+   in den Server-Eintrag,
+2. die Datei, die in der Umgebungsvariablen `LAYOUTBRIDGE_SPM_LICENSE_FILE`
+   steht,
+3. die Datei `license.key` am Vorgabeort – nur der Schlüssel, ohne weiteren
+   Text:
+   - Mac: `~/Library/Application Support/layoutbridge-spm/license.key`
+   - Windows: `%USERPROFILE%\.layoutbridge-spm\license.key`
+
+Den Ordner `layoutbridge-spm` bzw. `.layoutbridge-spm` legen Sie an, falls
+er fehlt. Ein nachgelegter oder geänderter Schlüssel wirkt ohne Neustart.
+
+**Prüfung:** Beim ersten Werkzeugaufruf prüft LayoutBridge den Schlüssel
+online; danach höchstens einmal in 24 Stunden. Ist der Dienst nicht
+erreichbar, arbeitet LayoutBridge ab der letzten gültigen Prüfung 14 Tage
+weiter und hängt jeder Antwort eine Warnung an; danach – oder wenn es noch
+nie eine gültige Prüfung gab – sind die Werkzeuge gesperrt, bis der
+Schlüssel wieder geprüft werden kann.
+
+**Ohne gültigen Schlüssel** antwortet jedes Werkzeug mit `ok: false` und
+`error.kind: "license"`. Die Meldung sagt im Klartext, ob der Schlüssel
+fehlt, abgelaufen, ungültig, für ein anderes Produkt oder gerade nicht
+prüfbar ist, und nennt den Ort, an dem der Schlüssel erwartet wurde;
+`error.details` nennt dazu die Support-Adresse und die Lizenzbedingungen.
+InDesign® wird dabei nicht angesprochen.
+
+**Was gespeichert und übertragen wird:** Das Ergebnis der letzten Prüfung
+steht in `license-state.json` neben `license.key` – mit einem
+Fingerabdruck des Schlüssels, nie dem Schlüssel selbst, und ohne
+Kundendaten. Zur Prüfung gehen der Lizenzschlüssel und eine Kennung dieses
+Arbeitsplatzes an den Zahlungsdienst Polar (`api.polar.sh`, USA). Die
+Kennung ist ein zufälliger Name der Form `layoutbridge-<8 Zeichen>`, der
+beim ersten Mal erzeugt und in
+`instance-name` neben `license.key` abgelegt wird; der Rechnername wird
+nicht verwendet. Wer im Händler-Konto einen lesbaren Namen möchte, setzt
+`LAYOUTBRIDGE_SPM_INSTANCE_NAME`. Dokumentinhalte, Dateipfade und
+Werkzeugaufrufe werden nie übertragen.
+
+## Rechnerwechsel
+
+Eine Lizenz ist auf einem Arbeitsplatz aktiv. Geben Sie sie auf dem alten
+Rechner frei, bevor Sie den Schlüssel auf dem neuen eintragen – ohne
+InDesign®, ohne Claude Desktop, aber mit Node.js ab Version 20:
+
+```
+npx layoutbridge-spm --deactivate
+```
+
+Der Befehl meldet im Klartext, ob die Freigabe geklappt hat, und löscht das
+lokale Prüfergebnis. Er liest den Schlüssel an denselben Orten wie der
+Server (siehe „Lizenzschlüssel“); beim Installationspaket verwahrt Claude
+Desktop den Schlüssel – legen Sie ihn dann vorher als `license.key` ab oder
+schreiben Sie an den Support. Haben Sie kein Node.js, weil Sie nur das
+Installationspaket nutzen, oder ist der alte Rechner nicht mehr erreichbar,
+können Sie die Aktivierung selbst im Kundenportal von Polar freigeben oder
+an den Support schreiben; er gibt die Aktivierung frei.
+
+## Konfiguration des Servers
+
+Vorgaben, die je Arbeitsplatz verschieden sind, lassen sich in einer
+JSON-Datei festlegen, die der Server beim Start liest: Pfad aus der
+Umgebungsvariablen `LAYOUTBRIDGE_SPM_CONFIG`, sonst auf dem Mac
+`~/Library/Application Support/layoutbridge-spm/config.json`, unter Windows
+`%USERPROFILE%\.layoutbridge-spm\config.json`. Fehlt die Datei, gelten die
+neutralen Vorgaben. Alle Schlüssel sind optional; ein Parameter im Aufruf
+geht immer vor.
+
+```json
+{
+  "tracking_warn_beyond": 20,
+  "min_ppi": 300,
+  "export_pdf": {
+    "preset": "Name des PDF-Presets",
+    "fallback_preset": "Name des Ausweichpresets",
+    "fallback_over_bytes": 4194304
+  }
+}
+```
+
+| Schlüssel | Wirkung |
+|---|---|
+| `tracking_warn_beyond` | `apply_character_format_to_range` warnt, wenn die Laufweite betragsmäßig darüber liegt. Ohne Eintrag keine Warnung. |
+| `min_ppi` | Vorgabe für den Parameter `min_ppi` von `place_image`, `scale_image_in_frame` und `fit_frame` (Warnung unter dieser effektiven Auflösung). Ohne Eintrag 300. |
+| `export_pdf.preset` | Vorgabe für `preset` von `export_pdf`. Ohne Eintrag das lokalisierte „High Quality Print“. |
+| `export_pdf.fallback_preset`, `export_pdf.fallback_over_bytes` | Zweiter Durchgang mit diesem Preset, wenn die Datei größer ist. Ohne Eintrag kein zweiter Durchgang. |
+
+Unbekannte Schlüssel und falsche Typen meldet der Server beim Start auf der
+Standardfehlerausgabe und ignoriert sie.
+
+## Protokoll
+
+Eine Zeile je Aufruf, eine Datei je laufender Instanz:
+`~/Library/Logs/layoutbridge-spm/` auf dem Mac,
+`%USERPROFILE%\.layoutbridge-spm\logs\` unter Windows; anderer Ort über die
+Umgebungsvariable `LAYOUTBRIDGE_SPM_LOG_DIR`. Das Protokoll bleibt auf
+Ihrem Rechner; es wird nirgendwohin gesendet.
+
+**Was in der Zeile steht (Vorgabe `basic`):** Zeitpunkt, Werkzeugname,
+Dauer, Erfolg, Fehlerart und Fehlertext, Warnungen und die **Namen** der
+übergebenen Parameter. Werte stehen nur dort, wo sie für die Fehlersuche
+nötig und harmlos sind (Zahlen, Kennungen, Aufzählungswerte, Dateipfade).
+Text, der Dokumentinhalt sein kann, erscheint nur als Längenangabe –
+`"<Text, 248 Zeichen>"`. In Pfaden wird Ihr Benutzerverzeichnis durch `~`
+ersetzt. Der Lizenzschlüssel wird nie protokolliert.
+
+**Tiefe einstellen –** `LAYOUTBRIDGE_SPM_LOG_LEVEL`:
+
+| Wert | Bedeutung |
+|---|---|
+| `off` | keine Protokollierung, es wird keine Datei angelegt |
+| `basic` | **Vorgabe**, gefiltert wie oben beschrieben |
+| `full` | alle Parameter im Wortlaut, Pfade mit Benutzernamen – nur für die Fehlersuche, auf Bitte des Supports |
+
+Läuft `full`, sagt das die erste Zeile im Protokoll und die Startmeldung des
+Servers. Danach wieder auf `basic` stellen.
+
+**Aufbewahrung:** Beim Start löscht der Server Protokolldateien, die älter
+als **30 Tage** sind. Andere Frist über `LAYOUTBRIDGE_SPM_LOG_KEEP_DAYS`
+(Zahl in Tagen; `0` schaltet das Löschen ab).
+
+## License terms
+
+Die Nutzung von LayoutBridge for Adobe InDesign® richtet sich nach den
+Lizenzbedingungen (EULA). Maßgeblich ist die deutsche Fassung.
+
+- Deutsch: https://mcp-schnittstellen.de/layoutbridge/lizenzbedingungen.html
+- English: https://mcp-interfaces.com/layoutbridge/license.html
+
+Der Server nennt die Adresse in seiner Startzeile und in jeder Antwort der
+Fehlerart `license` (`error.details.license_terms`).
+
+## Privacy Policy
+
+Welche Daten der Server verarbeitet – Lizenzprüfung beim Zahlungsdienst,
+Protokoll auf dem eigenen Rechner, nichts weiter – steht in der
+Datenschutzerklärung des Produkts:
+
+- Deutsch: https://mcp-schnittstellen.de/layoutbridge/datenschutz.html
+- English: https://mcp-interfaces.com/layoutbridge/privacy.html
+
+Die Lizenzprüfung ruft den Zahlungsdienst Polar auf; dessen
+Datenschutzerklärung: https://polar.sh/legal/privacy.
+
+## Support
+
+Fragen und Fehlermeldungen an **kontakt@mcp-interfaces.com**. Wir antworten
+an Werktagen, angestrebt innerhalb von zwei Werktagen. Hilfreich sind:
+Werkzeugname, Fehlertext im Wortlaut, Zeitpunkt, InDesign-Version und
+Betriebssystem. Schicken Sie uns **nie Ihren Lizenzschlüssel**.
+
+Eine kopierte Fehlermeldung kann Dateinamen und den Ordnerweg unterhalb
+Ihres Benutzerverzeichnisses sowie Bezeichnungen aus dem Dokument
+(Seiten, Rahmen, Formate) enthalten – keinen Benutzernamen, keinen
+Dokumenttext, keinen Lizenzschlüssel. Fehlerkorrekturen werden
+schnellstmöglich umgesetzt.
+
+## Third-party notices
+
+Das Paket enthält Software Dritter (Laufzeitabhängigkeiten einschließlich
+transitiver Pakete). Name, Version, Lizenz, Urheberzeile und vollständiger
+Lizenztext je Paket stehen in `THIRD-PARTY-NOTICES.md` (im npm-Paket und im
+Installationspaket enthalten).
+
+## Versionen und Changelog
+
+Ein Release im Monat mit Katalog der neuen Funktionen; Fehlerkorrekturen
+werden schnellstmöglich und unabhängig davon umgesetzt. Alle Änderungen
+stehen in `CHANGELOG.md` (im Paket enthalten). Innerhalb einer
+Hauptversion bleiben Werkzeugnamen, Parameter und Rückgabefelder stabil;
+Ergänzungen sind additiv.
+
+## Lizenz
+
+Proprietär, alle Rechte vorbehalten. Siehe `LICENSE`.