dsh-patch-edit-plus 0.4.6 → 0.4.8

package/INSTALL.de.md

@@ -0,0 +1,179 @@
+# Installationsanleitung (offizielle DSH-CLI)
+
+Diese Anleitung verwendet ausschließlich den offiziellen DSH-Befehl `dsh plugin`. Dieser Befehl installiert die Abhängigkeit in ein Profil und synchronisiert `dsh.profile.bundles`. Ersetzen Sie ihn nicht durch bloßes `npm install`, ein direktes `pnpm add` im Profil oder manuelle Bearbeitungen des Profil-Manifests.
+
+- [Englische Installationsanleitung](./INSTALL.md)
+- [Chinesische Installationsanleitung](./INSTALL.zh.md)
+- [Japanische Installationsanleitung](./INSTALL.ja.md)
+- [Koreanische Installationsanleitung](./INSTALL.ko.md)
+- [Deutsche Installationsanleitung](./INSTALL.de.md)
+- [Französische Installationsanleitung](./INSTALL.fr.md)
+- [Italienische Installationsanleitung](./INSTALL.it.md)
+- [Russische Installationsanleitung](./INSTALL.ru.md)
+- [Spanische Installationsanleitung](./INSTALL.es.md)
+- [Englisches README](./README.md)
+- [Chinesisches README](./README.zh.md)
+- [Japanisches README](./README.ja.md)
+- [Koreanisches README](./README.ko.md)
+- [Deutsches README](./README.de.md)
+- [Französisches README](./README.fr.md)
+- [Italienisches README](./README.it.md)
+- [Russisches README](./README.ru.md)
+- [Spanisches README](./README.es.md)
+- [Änderungsprotokoll](./CHANGELOG.md)
+- [Japanisches Änderungsprotokoll](./CHANGELOG.ja.md)
+- [Koreanisches Änderungsprotokoll](./CHANGELOG.ko.md)
+- [Deutsches Änderungsprotokoll](./CHANGELOG.de.md)
+- [Französisches Änderungsprotokoll](./CHANGELOG.fr.md)
+- [Italienisches Änderungsprotokoll](./CHANGELOG.it.md)
+- [Russisches Änderungsprotokoll](./CHANGELOG.ru.md)
+- [Spanisches Änderungsprotokoll](./CHANGELOG.es.md)
+
+Die Platzhalter in dieser Anleitung sind:
+
+- `<profile>`: das zu ändernde DSH-Profil, üblicherweise `web`;
+- `dsh-patch-edit-plus`: das npm-Paket, die Laufzeit-Plugin-ID und die ID der einzigen Zeile, die der Bundle-Patch einfügt.
+
+> **Unterstützter DSH-Bereich: `0.1.0-rc.8` bis `0.2.0-rc.2` (einschließlich Desktop) — eine einzige Version, v0.4.0.**
+>
+> Prüfen Sie zunächst mit `dsh --version` die laufende Version.
+>
+> | DSH-Version | Status | Hinweise |
+> | --- | --- | --- |
+> | `0.2.0-rc.1` ~ `0.2.0-rc.2` (einschließlich Desktop) | unterstützt | Dieselbe v0.4.0. |
+> | `0.1.0-rc.8` ~ `0.1.7-rc.2` | unterstützt | Dieselbe v0.4.0 — keine Auswahl von Zweig oder Dist-Tag nötig. |
+>
+> Installieren Sie auf jeder unterstützten Host-Linie `latest`: eine einzige Version bedient 0.1.x und 0.2.x gleichermaßen. Nach der Veröffentlichung zeigen die Dist-Tags `latest`, `dsh-0.2.0`, `dsh-0.1.7`, `dsh-0.1.5` und `dsh-0.1.2` alle auf 0.4.0.
+
+## 0. Voraussetzungen und Profil-Ermittlung
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+Benutzen Sie das Profil, das Ihr laufender DSH-Prozess nennt. `web` ist üblich, aber das aktive `--profile`-Argument ist maßgeblich.
+
+## 1. Offizielle Installation
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus -w
+```
+
+(Das Flag `-w` ist erforderlich, wenn das Profil eine pnpm-Workspace-Wurzel ist, wie es bei `web` der Fall ist.)
+
+Eine bestimmte Version explizit installieren:
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus@0.4.0 -w
+```
+
+Die offizielle CLI aktualisiert die Profil-Abhängigkeit, die Lockdatei und `dsh.profile.bundles` automatisch. Fügen Sie keine manuelle YAML-Zeile hinzu.
+
+### Abkühlphase der Lieferkette
+
+Die DSH-Laufzeit verwendet pnpm 11, dessen `minimumReleaseAge`-Richtlinie eine frisch veröffentlichte Version mit `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` blockieren kann. Fügen Sie die Version zu `minimumReleaseAgeExclude` in `~/.dsh/profiles/<profile>/pnpm-workspace.yaml` hinzu:
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-patch-edit-plus@0.4.0
+```
+
+## 2. Host neu starten
+
+Dies ist ein **reines Host-Plugin**: Es registriert ein Werkzeug und einen Einstellungsabschnitt auf dem Host und bringt keine Browser-Hälfte mit. Starten Sie den DSH-Host-Prozess nach jeder Installation oder Aktualisierung neu; ein Neuladen der Seite ist weder nötig noch ausreichend.
+
+## 3. Upgrade
+
+```bash
+dsh plugin --profile <profile> update dsh-patch-edit-plus -w
+```
+
+Starten Sie DSH danach neu.
+
+## 4. Registrierung über lokalen Pfad / `link:` (Alternative)
+
+```bash
+#    ~/.dsh/profiles/<profile>/package.json dependencies:
+#      "dsh-patch-edit-plus": "link:<absolute path to dsh-patch-edit-plus>"
+#    ~/.dsh/profiles/<profile>/cordis.patch.yml:
+#      - insert:
+#          - id: dsh-patch-edit-plus
+#            name: dsh-patch-edit-plus
+cd ~/.dsh/profiles/<profile> && pnpm install && dsh web
+```
+
+Oder verwenden Sie die offizielle CLI mit einem lokalen Pfad (kein Netz nötig):
+
+```bash
+dsh plugin --profile <profile> add /absolute/path/to/dsh-patch-edit-plus -w
+```
+
+Der Bau aus einem Quell-Checkout verwendet diese Skripte:
+
+```bash
+npm install
+npm run build          # tsc -p tsconfig.build.json → lib/ + lib/types/
+npm run typecheck      # tsc -p tsconfig.json
+npm run verify:source  # source-level assertions
+npm run test           # vitest run
+npm run smoke          # _smoke/load-smoke.mjs
+```
+
+`lib/` wird nicht eingecheckt, daher muss ein Quell-Checkout gebaut werden, bevor er per Pfad registriert werden kann. Die Veröffentlichung baut ihn automatisch über den `prepublishOnly`-Hook, sodass ein veröffentlichtes Tarball immer kompilierte Ausgabe enthält.
+
+## 5. Installation überprüfen
+
+```bash
+grep -n "dsh-patch-edit-plus" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-patch-edit-plus/package.json').version"
+```
+
+Prüfen Sie die offizielle Komposition:
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+Sie muss enthalten:
+
+```yaml
+- id: dsh-patch-edit-plus
+  name: dsh-patch-edit-plus
+```
+
+## 6. Das Plugin überprüfen
+
+Bestätigen Sie nach dem Neustart in einer Sitzung:
+
+1. Das Werkzeug `apply_patch` steht dem Modell zur Verfügung.
+2. Ein Unified-Diff-Patch wird angewendet, und der Dateiinhalt entspricht exakt dem Diff.
+3. Ein Patch, der die Verifikation nicht besteht, lässt den Workspace unangetastet — die Engine prüft alles lesend, bevor sie irgendetwas schreibt.
+4. Ein Patch im Codex-Stil liefert, während `allowCodexPatch` aus ist, einen umsetzbaren Hinweis, der dem Modell sagt, wie es den Stil aktiviert oder im Unified-Diff-Format wiederholt, statt eines generischen Parse-Fehlers.
+
+Stellt ein anderes Plugin bereits ein Werkzeug namens `apply_patch` bereit, entscheidet die dreistufige Konfliktrichtlinie (`rename` als Standard, sonst `skip` / `fail`). Beim Standard `rename` ist der DSH-Start unbeeinträchtigt und das Werkzeug wird unter einem Namen mit Suffix registriert.
+
+## 7. Fehlerbehebung
+
+| Symptom | Maßnahme |
+| --- | --- |
+| `dsh` wird nicht gefunden | Installieren oder aktivieren Sie die offizielle DSH-CLI. |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | Fügen Sie die Version zu `minimumReleaseAgeExclude` in der `pnpm-workspace.yaml` des Profils hinzu. |
+| `apply_patch` erscheint nicht | Starten Sie den Host-Prozess neu und prüfen Sie die Kompositions-Zeile erneut. |
+| Werkzeugnamens-Kollision mit einem anderen `apply_patch`-Provider | Stellen Sie die Konfliktrichtlinie auf `rename` (Standard), `skip` oder `fail`, siehe README. |
+| Codex-Syntax abgelehnt | Aktivieren Sie `allowCodexPatch: true` oder senden Sie die Änderung erneut als Unified Diff. |
+| Hunk-Fehlanpassung | Lesen Sie die vier Elemente der Diagnostik (Datei + Hunk-Index, Suchursprung, erwartete Vorschau, tatsächlicher Auszug) und senden Sie den Hunk mit passendem Kontext erneut. |
+
+## 8. Entfernen
+
+```bash
+dsh plugin --profile <profile> remove dsh-patch-edit-plus
+```
+
+Starten Sie DSH danach neu.
+
+## Lizenz
+
+MIT

package/INSTALL.es.md

@@ -0,0 +1,179 @@
+# Guía de instalación (CLI oficial de DSH)
+
+Esta guía usa únicamente el comando oficial de DSH `dsh plugin`. Ese comando instala la dependencia en un perfil y sincroniza `dsh.profile.bundles`. No lo sustituya por un `npm install` sencillo, un `pnpm add` directo en el perfil o ediciones manuales del manifiesto del perfil.
+
+- [Guía de instalación en inglés](./INSTALL.md)
+- [Guía de instalación en chino](./INSTALL.zh.md)
+- [Guía de instalación en japonés](./INSTALL.ja.md)
+- [Guía de instalación en coreano](./INSTALL.ko.md)
+- [Guía de instalación en español](./INSTALL.es.md)
+- [Guía de instalación en francés](./INSTALL.fr.md)
+- [Guía de instalación en alemán](./INSTALL.de.md)
+- [Guía de instalación en italiano](./INSTALL.it.md)
+- [Guía de instalación en ruso](./INSTALL.ru.md)
+- [README en inglés](./README.md)
+- [README en chino](./README.zh.md)
+- [README en japonés](./README.ja.md)
+- [README en coreano](./README.ko.md)
+- [README en español](./README.es.md)
+- [README en francés](./README.fr.md)
+- [README en alemán](./README.de.md)
+- [README en italiano](./README.it.md)
+- [README en ruso](./README.ru.md)
+- [Registro de cambios](./CHANGELOG.md)
+- [Registro de cambios en japonés](./CHANGELOG.ja.md)
+- [Registro de cambios en coreano](./CHANGELOG.ko.md)
+- [Registro de cambios en español](./CHANGELOG.es.md)
+- [Registro de cambios en francés](./CHANGELOG.fr.md)
+- [Registro de cambios en alemán](./CHANGELOG.de.md)
+- [Registro de cambios en italiano](./CHANGELOG.it.md)
+- [Registro de cambios en ruso](./CHANGELOG.ru.md)
+
+Los marcadores de posición de esta guía son:
+
+- `<profile>`: el perfil de DSH que hay que modificar, normalmente `web`;
+- `dsh-patch-edit-plus`: el paquete npm, el ID del plugin en tiempo de ejecución y el id de la única fila que inserta el parche del bundle.
+
+> **Rango de DSH admitido: de `0.1.0-rc.8` a `0.2.0-rc.2` (desktop incluido) — una única versión, la v0.4.0.**
+>
+> Compruebe primero la versión en ejecución con `dsh --version`.
+>
+> | Versión de DSH | Estado | Notas |
+> | --- | --- | --- |
+> | `0.2.0-rc.1` ~ `0.2.0-rc.2` (desktop incluido) | compatible | Misma v0.4.0. |
+> | `0.1.0-rc.8` ~ `0.1.7-rc.2` | compatible | Misma v0.4.0 — no hay que elegir rama ni dist-tag. |
+>
+> En cualquier línea de host admitida instale `latest`: una sola versión sirve tanto a los 0.1.x como a los 0.2.x. Tras la publicación, los dist-tags `latest`, `dsh-0.2.0`, `dsh-0.1.7`, `dsh-0.1.5` y `dsh-0.1.2` apuntarán todos a 0.4.0.
+
+## 0. Requisitos previos y descubrimiento del perfil
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+Use el perfil que indique su proceso de DSH en ejecución. `web` es habitual, pero el argumento `--profile` activo es lo que manda.
+
+## 1. Instalación oficial
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus -w
+```
+
+(la opción `-w` es obligatoria cuando el perfil es la raíz de un workspace de pnpm, como es el caso de `web`.)
+
+Instalar explícitamente una versión concreta:
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus@0.4.0 -w
+```
+
+La CLI oficial actualiza automáticamente la dependencia del perfil, el lockfile y `dsh.profile.bundles`. No añada una fila YAML manual.
+
+### Período de enfriamiento de la cadena de suministro
+
+El runtime de DSH usa pnpm 11, cuya política `minimumReleaseAge` puede bloquear una versión recién publicada con `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`. Añada la versión a `minimumReleaseAgeExclude` en `~/.dsh/profiles/<profile>/pnpm-workspace.yaml`:
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-patch-edit-plus@0.4.0
+```
+
+## 2. Reiniciar el host
+
+Este es un plugin **solo de host**: registra una herramienta y una sección de ajustes en el host, y no incluye ninguna parte de navegador. Reinicie el proceso host de DSH tras instalar o actualizar; recargar la página no es necesario ni suficiente.
+
+## 3. Actualización
+
+```bash
+dsh plugin --profile <profile> update dsh-patch-edit-plus -w
+```
+
+Reinicie DSH después.
+
+## 4. Registro por ruta local / `link:` (alternativa)
+
+```bash
+#    ~/.dsh/profiles/<profile>/package.json dependencies:
+#      "dsh-patch-edit-plus": "link:<absolute path to dsh-patch-edit-plus>"
+#    ~/.dsh/profiles/<profile>/cordis.patch.yml:
+#      - insert:
+#          - id: dsh-patch-edit-plus
+#            name: dsh-patch-edit-plus
+cd ~/.dsh/profiles/<profile> && pnpm install && dsh web
+```
+
+O use la CLI oficial con una ruta local (sin necesidad de red):
+
+```bash
+dsh plugin --profile <profile> add /absolute/path/to/dsh-patch-edit-plus -w
+```
+
+La compilación desde un checkout del código fuente usa estos scripts:
+
+```bash
+npm install
+npm run build          # tsc -p tsconfig.build.json → lib/ + lib/types/
+npm run typecheck      # tsc -p tsconfig.json
+npm run verify:source  # source-level assertions
+npm run test           # vitest run
+npm run smoke          # _smoke/load-smoke.mjs
+```
+
+`lib/` no se sube al repositorio, así que un checkout del código fuente debe compilarse antes de poder registrarse por ruta. La publicación lo compila automáticamente mediante el hook `prepublishOnly`, de modo que el tarball publicado siempre contiene la salida compilada.
+
+## 5. Verificar la instalación
+
+```bash
+grep -n "dsh-patch-edit-plus" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-patch-edit-plus/package.json').version"
+```
+
+Compruebe la composición oficial:
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+Debe contener:
+
+```yaml
+- id: dsh-patch-edit-plus
+  name: dsh-patch-edit-plus
+```
+
+## 6. Verificar el plugin
+
+Tras el reinicio, confirme en una sesión:
+
+1. La herramienta `apply_patch` está disponible para el modelo.
+2. Un parche en diff unificado se aplica y el contenido del archivo coincide exactamente con el diff.
+3. Un parche que no supera la verificación deja el workspace intacto — el motor verifica todo en modo de solo lectura antes de escribir nada.
+4. Un parche estilo Codex con `allowCodexPatch` desactivado devuelve una pista accionable que indica al modelo cómo activar el estilo o reintentar en diff unificado, en lugar de un error genérico de análisis.
+
+Si otro plugin ya proporciona una herramienta llamada `apply_patch`, la política de conflictos de tres niveles (`rename` por defecto, o `skip` / `fail`) decide el resultado. Con el `rename` por defecto, el arranque de DSH no se ve afectado y la herramienta se registra con un nombre con sufijo.
+
+## 7. Solución de problemas
+
+| Síntoma | Acción |
+| --- | --- |
+| `dsh` no se encuentra | Instale o habilite la CLI oficial de DSH. |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | Añada la versión a `minimumReleaseAgeExclude` en el `pnpm-workspace.yaml` del perfil. |
+| `apply_patch` no aparece | Reinicie el proceso host y vuelva a comprobar la fila de la composición. |
+| Choque de nombre de herramienta con otro proveedor de `apply_patch` | Fije la política de conflictos en `rename` (por defecto), `skip` o `fail`, según el README. |
+| Sintaxis de Codex rechazada | Active `allowCodexPatch: true` o reenvíe el cambio como diff unificado. |
+| Hunk que no coincide | Lea el diagnóstico de cuatro elementos (archivo + índice del hunk, origen de la búsqueda, vista previa esperada, extracto real) y reenvíe el hunk con un contexto coincidente. |
+
+## 8. Desinstalación
+
+```bash
+dsh plugin --profile <profile> remove dsh-patch-edit-plus
+```
+
+Reinicie DSH después.
+
+## Licencia
+
+MIT

package/INSTALL.fr.md

@@ -0,0 +1,179 @@
+# Guide d'installation (CLI DSH officiel)
+
+Ce guide n'utilise que la commande officielle DSH `dsh plugin`. Cette commande installe la dépendance dans un profil et synchronise `dsh.profile.bundles`. Ne la remplacez pas par un simple `npm install`, un `pnpm add` direct dans le profil, ou des modifications manuelles du manifeste du profil.
+
+- [Guide d'installation en anglais](./INSTALL.md)
+- [Guide d'installation en chinois](./INSTALL.zh.md)
+- [Guide d'installation en japonais](./INSTALL.ja.md)
+- [Guide d'installation en coréen](./INSTALL.ko.md)
+- [Guide d'installation en français](./INSTALL.fr.md)
+- [Guide d'installation en allemand](./INSTALL.de.md)
+- [Guide d'installation en italien](./INSTALL.it.md)
+- [Guide d'installation en russe](./INSTALL.ru.md)
+- [Guide d'installation en espagnol](./INSTALL.es.md)
+- [README en anglais](./README.md)
+- [README en chinois](./README.zh.md)
+- [README en japonais](./README.ja.md)
+- [README en coréen](./README.ko.md)
+- [README en français](./README.fr.md)
+- [README en allemand](./README.de.md)
+- [README en italien](./README.it.md)
+- [README en russe](./README.ru.md)
+- [README en espagnol](./README.es.md)
+- [Changelog](./CHANGELOG.md)
+- [Changelog en japonais](./CHANGELOG.ja.md)
+- [Changelog en coréen](./CHANGELOG.ko.md)
+- [Changelog en français](./CHANGELOG.fr.md)
+- [Changelog en allemand](./CHANGELOG.de.md)
+- [Changelog en italien](./CHANGELOG.it.md)
+- [Changelog en russe](./CHANGELOG.ru.md)
+- [Changelog en espagnol](./CHANGELOG.es.md)
+
+Les espaces réservés de ce guide sont :
+
+- `<profile>` : le profil DSH à modifier, généralement `web` ;
+- `dsh-patch-edit-plus` : le paquet npm, l'identifiant du plugin à l'exécution, et l'id de l'unique ligne insérée par le patch de bundle.
+
+> **Plage de DSH prise en charge : de `0.1.0-rc.8` à `0.2.0-rc.2` (desktop inclus) — une version unique, la v0.4.0.**
+>
+> Vérifiez d'abord la version en cours avec `dsh --version`.
+>
+> | Version de DSH | Statut | Notes |
+> | --- | --- | --- |
+> | `0.2.0-rc.1` ~ `0.2.0-rc.2` (desktop inclus) | pris en charge | Même v0.4.0. |
+> | `0.1.0-rc.8` ~ `0.1.7-rc.2` | pris en charge | Même v0.4.0 — aucun choix de branche ni de dist-tag n'est nécessaire. |
+>
+> Sur toute ligne d'hôte prise en charge, installez `latest` : une seule version sert aussi bien les 0.1.x que les 0.2.x. Après publication, les dist-tags `latest`, `dsh-0.2.0`, `dsh-0.1.7`, `dsh-0.1.5` et `dsh-0.1.2` pointeront tous vers 0.4.0.
+
+## 0. Prérequis et découverte du profil
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+Utilisez le profil nommé par votre processus DSH en cours d'exécution. `web` est courant, mais c'est l'argument `--profile` actif qui fait foi.
+
+## 1. Installation officielle
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus -w
+```
+
+(le drapeau `-w` est requis quand le profil est une racine d'espace de travail pnpm, comme c'est le cas de `web`.)
+
+Pour installer explicitement une version précise :
+
+```bash
+dsh plugin --profile <profile> add dsh-patch-edit-plus@0.4.0 -w
+```
+
+La CLI officielle met à jour automatiquement la dépendance du profil, le lockfile et `dsh.profile.bundles`. N'ajoutez pas de ligne YAML manuelle.
+
+### Période de refroidissement de la chaîne d'approvisionnement
+
+Le runtime DSH utilise pnpm 11, dont la politique `minimumReleaseAge` peut bloquer une version tout juste publiée avec `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`. Ajoutez la version à `minimumReleaseAgeExclude` dans `~/.dsh/profiles/<profile>/pnpm-workspace.yaml` :
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-patch-edit-plus@0.4.0
+```
+
+## 2. Redémarrer l'hôte
+
+C'est un plugin **réservé à l'hôte** : il enregistre un outil et une section de paramètres sur l'hôte, et n'embarque aucune partie navigateur. Redémarrez le processus hôte DSH après chaque installation ou mise à niveau ; rafraîchir la page n'est ni nécessaire ni suffisant.
+
+## 3. Mise à niveau
+
+```bash
+dsh plugin --profile <profile> update dsh-patch-edit-plus -w
+```
+
+Redémarrez DSH ensuite.
+
+## 4. Enregistrement par chemin local / `link:` (alternative)
+
+```bash
+#    ~/.dsh/profiles/<profile>/package.json dependencies:
+#      "dsh-patch-edit-plus": "link:<absolute path to dsh-patch-edit-plus>"
+#    ~/.dsh/profiles/<profile>/cordis.patch.yml:
+#      - insert:
+#          - id: dsh-patch-edit-plus
+#            name: dsh-patch-edit-plus
+cd ~/.dsh/profiles/<profile> && pnpm install && dsh web
+```
+
+Ou utilisez la CLI officielle avec un chemin local (aucun réseau requis) :
+
+```bash
+dsh plugin --profile <profile> add /absolute/path/to/dsh-patch-edit-plus -w
+```
+
+La construction depuis un checkout des sources utilise ces scripts :
+
+```bash
+npm install
+npm run build          # tsc -p tsconfig.build.json → lib/ + lib/types/
+npm run typecheck      # tsc -p tsconfig.json
+npm run verify:source  # source-level assertions
+npm run test           # vitest run
+npm run smoke          # _smoke/load-smoke.mjs
+```
+
+`lib/` n'est pas versionné ; un checkout des sources doit donc être construit avant de pouvoir être enregistré par chemin. La publication le construit automatiquement via le hook `prepublishOnly`, si bien que le tarball publié contient toujours la sortie compilée.
+
+## 5. Vérifier l'installation
+
+```bash
+grep -n "dsh-patch-edit-plus" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-patch-edit-plus/package.json').version"
+```
+
+Vérifiez la composition officielle :
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+Elle doit contenir :
+
+```yaml
+- id: dsh-patch-edit-plus
+  name: dsh-patch-edit-plus
+```
+
+## 6. Vérifier le plugin
+
+Après le redémarrage, confirmez dans une session :
+
+1. L'outil `apply_patch` est disponible pour le modèle.
+2. Un patch en diff unifié s'applique, et le contenu du fichier correspond exactement au diff.
+3. Un patch qui échoue à la vérification laisse l'espace de travail intact — le moteur vérifie tout en lecture seule avant d'écrire quoi que ce soit.
+4. Un patch de style Codex reçu alors que `allowCodexPatch` est désactivé renvoie une aide actionnable indiquant au modèle comment activer ce style ou réessayer en diff unifié, plutôt qu'une erreur d'analyse générique.
+
+Si un autre plugin fournit déjà un outil nommé `apply_patch`, la politique de conflit à trois niveaux (`rename` par défaut, ou `skip` / `fail`) décide de l'issue. Avec le `rename` par défaut, le démarrage de DSH n'est pas affecté et l'outil est enregistré sous un nom suffixé.
+
+## 7. Dépannage
+
+| Symptôme | Action |
+| --- | --- |
+| `dsh` est introuvable | Installez ou activez la CLI DSH officielle. |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | Ajoutez la version à `minimumReleaseAgeExclude` dans le `pnpm-workspace.yaml` du profil. |
+| `apply_patch` n'apparaît pas | Redémarrez le processus hôte et revérifiez la ligne de composition. |
+| Conflit de nom d'outil avec un autre fournisseur d'`apply_patch` | Réglez la politique de conflit sur `rename` (défaut), `skip` ou `fail` selon le README. |
+| Syntaxe Codex rejetée | Activez `allowCodexPatch: true`, ou renvoyez la modification sous forme de diff unifié. |
+| Hunk non correspondant | Lisez le diagnostic à quatre éléments (fichier + index du hunk, origine de recherche, aperçu attendu, extrait réel) et réémettez le hunk avec un contexte correspondant. |
+
+## 8. Suppression
+
+```bash
+dsh plugin --profile <profile> remove dsh-patch-edit-plus
+```
+
+Redémarrez DSH ensuite.
+
+## Licence
+
+MIT