dsh-date-wrapper 0.2.0 → 0.4.0

package/README.fr.md

@@ -0,0 +1,236 @@
+# dsh-date-wrapper
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+> La liste des versions de DSH prises en charge est **gérée par script, non rédigée à la main** — voir le bloc généré ci-dessous (source unique : `scripts/hosts.mjs` ; distribué par `scripts/sync-hosts.mjs` vers `package.json` peerDependencies + engines.dsh, `dsh.plugin.json` et ce README en neuf langues). Le contrat côté hôte du plugin est unique : `systemPrompt.context({ name, order, text })` ; il n'enregistre aucun espace de noms de réglages, ne lit aucune donnée de session et n'effectue aucun appel RPC — les réécritures côté hôte ne le touchent pas.
+
+> Une ligne de date minimaliste : elle suspend `Current date: 2026-09-08 Asia/Shanghai Tuesday` (46 caractères, ~12 tokens) à l'instantané du contexte d'exécution que DSH envoie déjà.
+> Elle ne charge **pas** `@deepseek-ai/dsh-time-context`, n'ajoute **aucun** message de session supplémentaire, ne modifie **pas** le code source de DSH et ne nécessite aucune PR.
+
+- [Fonctionnement : sessions DSH, JSONL et assemblage des requêtes](./docs/dsh-session-and-context-mechanics.md) (en chinois)
+- [HANDOVER.md](./HANDOVER.md) (en chinois)
+
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Hôtes DSH pris en charge :** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc sur les lignes 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Vérifié à l'exécution :** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` — preuves dans `.compat-results/`
+<!-- host-compat:end -->
+
+## Ce que ce plugin résout
+
+Le `@deepseek-ai/dsh-time-context` intégré à DSH injecte environ **280 caractères** de métadonnées à chaque requête :
+
+```
+Time sampled while preparing turn 3, step 2: 2026-09-08T16:05:36+08:00[Asia/Shanghai]
+Browser time zone for this request: Asia/Shanghai. Interpret otherwise-unqualified dates and times in this zone.
+Elapsed since the preceding model-visible message: 2m 34s.
+```
+
+Ce plugin compresse la même information en une seule ligne de **46 caractères** et change son point d'arrivée — elle ne va plus dans le flux de messages :
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+| Dimension | `dsh-time-context` | `dsh-date-wrapper` |
+|-----------|--------------------|--------------------|
+| Texte injecté | ~280 caractères | 46 caractères (↓84 %), ~12 tokens |
+| Point d'arrivée | Un message par pre-step (`user/message`) | L'instantané du contexte d'exécution de la plateforme (`systemPrompt.context`) |
+| Fréquence | Un événement par step éligible | Renvoyé avec l'instantané uniquement quand le texte change (0 événement dans une même journée) |
+| Dépendance | Service `agents` | Service `systemPrompt` |
+| Dépendances d'exécution | — | aucune |
+
+## Compatibilité des versions
+
+| Élément | Verdict |
+|------|---------|
+| Versions DSH ciblées | énumération gérée par script — `scripts/hosts.mjs` (15 rc sur les lignes 0.1.0 → 0.2.0) ; liste vérifiée à l'exécution dans le bloc généré en tête |
+| API settings | **Non applicable** : le plugin n'enregistre aucun réglage et n'exporte aucun `Config` schemastery |
+| Points de contrat utilisés | Un seul — `systemPrompt.context()` |
+| Conflit avec une fonctionnalité native | Chevauche `@deepseek-ai/dsh-time-context` ; **ne pas utiliser les deux**. Non installé par défaut = désactivé par défaut |
+| Partie navigateur | **Aucune** : pas de slot, pas de DOM, pas de token sémantique CSS |
+| Imports de paquets DSH | **Zéro** : rien de `@deepseek-ai/*`, ce qui est plus strict que le motif « détection à l'exécution + repli sur double API » |
+
+| Point de contrat | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
+|---|---|---|---|---|---|---|
+| `systemPrompt.context(ctx): () => void` | oui | oui (vérifié sur cet hôte) | oui | oui | oui | oui (diff par rapport à 0.1.7-rc.2 : chaîne de version uniquement) |
+| `PromptContext = { name, order, text }`, sans champ `complete` | oui | oui | oui | oui | oui | oui |
+| `includeRuntimeContext` / `suppressRuntimeContext` | oui | oui | oui | oui | oui | oui |
+| déduplication par texte du `project()` d'agent-loop et `surfaceOp: "append"` | oui | oui | oui | non comparé | oui | oui |
+| `order: 116` sans collision (110 / 115 / 120 déjà pris) | oui | oui | oui | oui | oui | oui |
+
+> Méthode : `npm pack @deepseek-ai/dsh-system-prompt@<version>`, décompression, puis comparaison de `lib/types/index.d.ts` et `lib/index.js` ; idem pour `@deepseek-ai/dsh-agent-loop`.
+> Entre `dsh-v0.1.7-rc.2` et `dsh-v0.2.0-rc.1`, le diff de `packages/core/system-prompt` tient en une seule ligne de version, les sites d'appel `systemPrompt.context` en 110/115/120 sont inchangés et le guide de migration des plugins ne mentionne aucun `systemPrompt`.
+> Seule la 0.1.1-rc.2 a été vérifiée **à l'exécution** sur cet hôte ; le test de fumée à l'exécution de la 0.2.0-rc.1 est suivi dans `HANDOVER.md` §7.
+
+## Pourquoi un instantané du contexte d'exécution plutôt qu'un message
+
+La première tentative imitait `dsh-time-context` en ajoutant un `user/message` dans `agent/pre-step`. Le coût mesuré était trop élevé : chaque événement JSONL pèse **339 octets** (le texte n'en représente que 46, car `content` et `sections` stockent chacun une copie) et il en écrivait **un à chaque tour**.
+
+Enregistrer un contexte d'exécution à la place fond la date dans le message d'instantané que la plateforme envoie déjà :
+
+- La plateforme **déduplique les instantanés par texte** (`RuntimeContextProjection.project()` dans `dsh-agent-loop` : `if (this.retained?.text === snapshot) return`) ; tant que la date ne change pas, **pas un seul événement supplémentaire n'est écrit** ;
+- Les instantanés **ajoutent** un nouveau message (`surfaceOp: 'append'`) au lieu de réécrire en place, la séquence de requêtes ne fait que croître → **le cache de préfixe est préservé** ;
+- Notre coût marginal se limite à ces 46 octets, et uniquement quand l'instantané est renvoyé parce que son texte a changé.
+
+Mesuré sur cet hôte (une session réelle, 10 tours / 231 étapes) :
+
+| Élément | Mesuré |
+|------|----------|
+| Instantanés de contexte d'exécution de la plateforme | 2 événements, 1133 o chacun, 2,3 Ko au total |
+| Vrais messages utilisateur | 10 événements, 396 o chacun |
+| Ancienne approche (un message par tour) | 10 × 339 o ≈ 3,4 Ko |
+| Cette approche | 0 événement supplémentaire ; ~46 o fondus dans un instantané existant |
+
+## Configuration
+
+Livré avec `cordis.patch.yml` ; redémarrer après modification :
+
+```yaml
+- insert:
+    - id: date-wrapper
+      name: dsh-date-wrapper
+      config:
+        timeZone: Asia/Shanghai   # IANA zone; omit to use the process zone
+```
+
+- Un `timeZone` invalide lève une exception au démarrage (**aucun** repli silencieux sur UTC).
+- Le nom de zone dans le texte est le nom IANA résolu (le nom de la zone du processus quand `timeZone` est omis).
+- L'entrée de contexte d'exécution s'appelle `date-wrapper:date` avec l'ordre `116` (déjà pris : 110 sandbox, 115 approval, 120 subagent).
+- Le plugin n'exporte **aucun `Config` schemastery** : sa configuration échappe à la validation de schéma de l'hôte ; tout est validé à la main dans `validateConfig()`. C'est aussi pourquoi la page Settings → Plugins n'affiche aucun formulaire de configuration pour lui.
+
+## Marche/arrêt : l'activation du plugin fait office d'interrupteur, il n'y a pas de bouton dans un panneau
+
+Le plugin n'embarque **ni** bouton dans un panneau de réglages **ni** champ de configuration `enabled`, parce que :
+
+- L'interrupteur, c'est *l'état actif de la ligne du plugin*. Inactive → `apply()` ne s'exécute jamais → l'entrée de contexte d'exécution n'existe pas → pas un seul caractère injecté.
+- Il n'y a pas de partie navigateur (`dsh.client`), donc l'UI ne possède aucun widget de notre part.
+- La page **Settings → Plugins** intégrée à DSH affiche déjà chaque entrée comme `enabled / disabled` (en lecture seule).
+
+### Comment le désactiver
+
+Surchargez-le par `id` dans **votre propre** couche de patch de profil — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml` :
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **À chaud, sans redémarrage** : ce fichier est surveillé par le HMR de Cordis, et `disabled: true` détruit directement la fiber de la ligne.
+- Si la ligne `date-wrapper` n'existe pas encore (non installé), ce patch se contente d'un avertissement `entry "date-wrapper" not found` dans les logs ; le démarrage réussit quand même.
+- ⚠️ Le fichier doit être un **tableau YAML de premier niveau** ; s'il est mal formé, **le démarrage échoue** (DSH est fail-loud pour les couches de patch utilisateur).
+
+### Comment le supprimer complètement
+
+```bash
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+La suppression passe par la couche bundle et **nécessite un redémarrage** de dsh web (les patches de bundle ne sont pas rechargés à chaud).
+
+## Installation
+
+```bash
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Redémarrez dsh web et rafraîchissez la page. Chemins locaux, mode link et dépannage : [INSTALL.fr.md](./INSTALL.fr.md).
+
+## Vérification
+
+| # | Comment | Attendu |
+|---|-----|----------|
+| A1 | Ouvrir une nouvelle session et envoyer un message | L'instantané du contexte d'exécution contient `Current date: YYYY-MM-DD <zone> <weekday>` (affiché comme une ligne de contexte injecté provenant de `system-prompt`) |
+| A2 | Vérifier cette ligne | ≤50 caractères (46 mesurés ; le seuil PRD de 30 a été assoupli pour le format demandé) |
+| A3 | Désactiver le plugin (patch de profil `disabled: true`) | La ligne n'apparaît plus dans les instantanés des sessions suivantes |
+| A4 | Chercher dans le journal de session | Aucun `Time sampled` / `Elapsed since` / `Browser time zone` |
+| A5 | Mettre `timeZone` à `UTC` et redémarrer | La date suit UTC (peut différer d'un jour à cheval sur deux zones) |
+
+## Notes d'implémentation
+
+```
+dsh-date-wrapper/
+├── package.json          # name / type: module / main / exports["."] / dsh.bundle.patch / files
+├── cordis.patch.yml      # one insert row (no patch-level id → lands at the profile root = host plane)
+├── src/
+│   ├── format.js         # pure functions: resolveZone / renderDate / createDateContextText / validateConfig / TEXT_LABEL
+│   └── index.js          # apply(ctx, config) → ctx.inject(['systemPrompt'], …) → systemPrompt.context(...)
+└── tests/
+    ├── format.test.mjs   # 11 cases (zone projection, weekday, format and length, degradation, config validation)
+    └── context.test.mjs  # 7 cases (registration contract against a fake ctx)
+```
+
+- **Ligne côté hôte** : `ctx.inject(['systemPrompt'], …)` ouvre une fiber enfant ; si le service est absent, le plugin n'enregistre rien silencieusement au lieu de faire échouer tout le démarrage.
+- **Fournisseur de texte fail-soft** : une exception pendant l'assemblage du prompt ferait échouer **chaque** requête ; un échec de rendu renvoie donc une chaîne vide (la plateforme filtre le texte vide).
+- **Pas de `complete`** : le définir masquerait la totalité du prompt système.
+- **La déduplication est l'affaire de la plateforme** : aucun état par agent n'est conservé ; au passage de minuit, l'instantané porte simplement la nouvelle date.
+- **Cycle de vie** : l'enregistrement appartient à la fiber enfant de `ctx.inject` et est récupéré quand le plugin est désactivé.
+
+## Développement : TDD + lint
+
+```bash
+npm install          # devDependencies only (eslint / @eslint/js); zero runtime dependencies
+
+npm run tdd          # watch mode: rerun on src/ or tests/ changes (node --test --watch)
+npm test             # one full run: node --test "tests/*.test.mjs"
+node tests/format.test.mjs   # run a single file (most reliable under a sandbox: no child process)
+
+npm run lint         # eslint . (src + tests + eslint.config.mjs)
+npm run lint:fix     # auto-fix what can be fixed
+npm run verify       # lint + test; run this before committing
+```
+
+### Rouge-vert-refactorisation
+
+Les cas de test correspondent directement aux critères d'acceptation : écrire d'abord une assertion qui échoue, puis la faire passer.
+
+| Étape | Action | Commande |
+|------|--------|---------|
+| 1 rouge | Ajouter dans `tests/*.test.mjs` une assertion nommée d'après le critère d'acceptation, qui affirme un comportement que vous n'avez **pas** encore | `npm run tdd` |
+| 2 vert | Écrire dans `src/` l'implémentation minimale pour la faire passer, sans toucher aux autres assertions | `npm run tdd` |
+| 3 refactorisation | Renommer et extraire des fonctions pures en restant au vert ; `src/format.js` concentre toute la logique pure, `src/index.js` ne fait qu'enregistrer | `npm run tdd` |
+| 4 barrière | Lancer lint + la suite complète avant de committer | `npm run verify` |
+
+18 assertions aujourd'hui : `format.test.mjs` (11) couvre les fonctions pures, `context.test.mjs` (7) vérifie le contrat d'enregistrement contre un ctx factice.
+
+### Points marquants de la configuration lint
+
+- ESLint 10 en configuration plate (`eslint.config.mjs`) avec `@eslint/js` recommended comme base.
+- Règles resserrées : `eqeqeq`, `prefer-const`, `object-shorthand`, `no-unused-vars` (préfixe `_` exempté).
+- Les globales Node `crypto` / `console` / `process` sont déclarées explicitement, sinon `no-undef` produit de faux positifs.
+
+## Limitations connues
+
+- **Inactif sous les presets à prompt fixe** : si la persona d'un preset définit `includeRuntimeContext: false` (c'est le cas du `minimal` officiel et du `simple-reply` local), `assemble()` renvoie `contexts: []` et l'entrée de ce plugin est jetée en bloc. Ces presets sont conçus pour interdire aux listeners ultérieurs d'ajouter quoi que ce soit au prompt.
+- **Les anciens instantanés restent dans l'historique** : quand la date change, la plateforme ajoute un nouvel instantané (l'ancien est conservé) et le nouveau prend effet grâce à sa propre déclaration « This snapshot supersedes earlier runtime-context snapshots » — de la même manière que la plateforme gère les changements de cwd / sandbox / politique d'approbation.
+- **Les patches de bundle ne sont pas rechargés à chaud** : modifier `cordis.patch.yml` ou mettre à jour le plugin impose un redémarrage de dsh web (changer `disabled` dans le patch de profil est hot).
+- **`dsh-time-context` n'est ni chargé ni filtré** : si vous le montez explicitement dans un preset, son texte verbeux apparaît comme d'habitude. Ne pas utiliser les deux.
+- **Pas de sonde à l'exécution pour le point de contrat** : `systemPrompt.context` est appelé sans garde ; un futur renommage côté DSH se manifestera donc par un échec de chargement du plugin plutôt que par une dégradation silencieuse (voir `HANDOVER.md` §7).
+
+## Licence
+
+MIT

package/README.it.md

@@ -0,0 +1,236 @@
+# dsh-date-wrapper
+
+- [English README](./README.md)
+- [中文 README](./README.zh.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+> L'elenco delle versioni DSH supportate è **gestito da script, non scritto a mano** — vedi il blocco generato sotto (fonte unica: `scripts/hosts.mjs`; distribuito da `scripts/sync-hosts.mjs` a `package.json` peerDependencies + engines.dsh, `dsh.plugin.json` e questo README in nove lingue). L'unico contratto lato host del plugin è `systemPrompt.context({ name, order, text })`; non registra namespace di impostazioni, non legge dati di sessione e non fa chiamate RPC — le riscritture lato host non lo toccano.
+
+> Una riga di data minimale: appende `Current date: 2026-09-08 Asia/Shanghai Tuesday` (46 caratteri, ~12 token) allo snapshot del contesto di runtime che DSH invia già di suo.
+> **Non** carica `@deepseek-ai/dsh-time-context`, **non** aggiunge messaggi di sessione extra, **non** patcha il sorgente di DSH e non richiede PR.
+
+- [Come funziona: sessioni DSH, JSONL e assemblaggio delle richieste](./docs/dsh-session-and-context-mechanics.md) (cinese)
+- [HANDOVER.md](./HANDOVER.md) (cinese)
+
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Host DSH supportati:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc attraverso le linee 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Verificato a runtime:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` — prove in `.compat-results/`
+<!-- host-compat:end -->
+
+## Che problema risolve questo plugin
+
+Il `@deepseek-ai/dsh-time-context` di DSH inietta circa **280 caratteri** di metadati a ogni richiesta:
+
+```
+Time sampled while preparing turn 3, step 2: 2026-09-08T16:05:36+08:00[Asia/Shanghai]
+Browser time zone for this request: Asia/Shanghai. Interpret otherwise-unqualified dates and times in this zone.
+Elapsed since the preceding model-visible message: 2m 34s.
+```
+
+Questo plugin comprime la stessa informazione in un'unica riga di **46 caratteri** e ne cambia il punto di arrivo — non va più nel flusso dei messaggi:
+
+```
+Current date: 2026-09-08 Asia/Shanghai Tuesday
+```
+
+| Dimensione | `dsh-time-context` | `dsh-date-wrapper` |
+|-----------|--------------------|--------------------|
+| Testo iniettato | ~280 caratteri | 46 caratteri (↓84%), ~12 token |
+| Punto di arrivo | Un messaggio per ogni pre-step (`user/message`) | Lo snapshot del contesto di runtime della piattaforma (`systemPrompt.context`) |
+| Frequenza | Un evento per ogni step idoneo | Reinviate con lo snapshot solo quando il testo cambia (0 eventi nello stesso giorno) |
+| Dipendenza | Servizio `agents` | Servizio `systemPrompt` |
+| Dipendenze di runtime | — | nessuna |
+
+## Compatibilità delle versioni
+
+| Voce | Verdetto |
+|------|---------|
+| Versioni DSH target | enum gestita da script — `scripts/hosts.mjs` (15 rc sulle linee 0.1.0 → 0.2.0); lista verificata a runtime nel blocco generato in testa |
+| API settings | **Non applicabile**: il plugin non registra impostazioni né esporta un `Config` schemastery |
+| Punti di contratto usati | Esattamente uno — `systemPrompt.context()` |
+| Conflitto con una funzionalità nativa | Si sovrappone a `@deepseek-ai/dsh-time-context`; **non usare entrambi**. Non installato per default = disattivato per default |
+| Metà browser | **Nessuna**: nessuno slot, nessun DOM, nessun token semantico CSS |
+| Import di pacchetti DSH | **Zero**: niente da `@deepseek-ai/*`, il che è più rigido del pattern «rilevamento a runtime + fallback su doppia API» |
+
+| Punto di contratto | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
+|---|---|---|---|---|---|---|
+| `systemPrompt.context(ctx): () => void` | sì | sì (verificato su questo host) | sì | sì | sì | sì (diff rispetto a 0.1.7-rc.2: solo la stringa di versione) |
+| `PromptContext = { name, order, text }`, senza campo `complete` | sì | sì | sì | sì | sì | sì |
+| `includeRuntimeContext` / `suppressRuntimeContext` | sì | sì | sì | sì | sì | sì |
+| deduplica per testo del `project()` di agent-loop e `surfaceOp: "append"` | sì | sì | sì | non confrontato | sì | sì |
+| `order: 116` senza collisioni (110 / 115 / 120 occupati) | sì | sì | sì | sì | sì | sì |
+
+> Metodo: `npm pack @deepseek-ai/dsh-system-prompt@<version>`, scompattare e confrontare `lib/types/index.d.ts` e `lib/index.js`; identico per `@deepseek-ai/dsh-agent-loop`.
+> Tra `dsh-v0.1.7-rc.2` e `dsh-v0.2.0-rc.1` il diff di `packages/core/system-prompt` è una sola riga di versione, i punti di chiamata `systemPrompt.context` su 110/115/120 sono invariati e la guida alla migrazione dei plugin non ha alcuna voce `systemPrompt`.
+> Solo 0.1.1-rc.2 è stata verificata **a runtime** su questo host; lo smoke test a runtime di 0.2.0-rc.1 è tracciato in `HANDOVER.md` §7.
+
+## Perché uno snapshot del contesto di runtime invece di un messaggio
+
+Il primo tentativo copiava `dsh-time-context` e aggiungeva un `user/message` in `agent/pre-step`. Il costo misurato era troppo alto: ogni evento JSONL pesa **339 byte** (il testo ne occupa solo 46, perché `content` e `sections` ne conservano ciascuno una copia) e ne veniva scritto **uno a ogni turno**.
+
+Registrando invece un contesto di runtime, la data si fonde nel messaggio di snapshot che la piattaforma invia già:
+
+- La piattaforma **deduplica gli snapshot per testo** (`RuntimeContextProjection.project()` in `dsh-agent-loop`: `if (this.retained?.text === snapshot) return`), quindi finché la data non cambia **non viene scritto nemmeno un evento extra**;
+- Gli snapshot **aggiungono** un nuovo messaggio (`surfaceOp: 'append'`) invece di riscrivere sul posto, quindi la sequenza delle richieste fa solo crescere → **la cache dei prefissi resta preservata**;
+- Il nostro costo marginale sono quei 46 byte, e solo quando lo snapshot viene reinvato perché il suo testo è cambiato.
+
+Misurato su questo host (una sessione reale, 10 turni / 231 step):
+
+| Voce | Misurato |
+|------|----------|
+| Snapshot del contesto di runtime della piattaforma | 2 eventi, 1133 B ciascuno, 2,3 KB in totale |
+| Messaggi reali dell'utente | 10 eventi, 396 B ciascuno |
+| Approccio vecchio (un messaggio per turno) | 10 × 339 B ≈ 3,4 KB |
+| Questo approccio | 0 eventi extra; ~46 B ripiegati in uno snapshot esistente |
+
+## Configurazione
+
+Spedito con `cordis.patch.yml`; riavviare dopo averlo modificato:
+
+```yaml
+- insert:
+    - id: date-wrapper
+      name: dsh-date-wrapper
+      config:
+        timeZone: Asia/Shanghai   # IANA zone; omit to use the process zone
+```
+
+- Un `timeZone` non valido lancia un'eccezione all'avvio (**nessun** fallback silenzioso su UTC).
+- Il nome della zona nel testo è il nome IANA risolto (il nome della zona del processo quando `timeZone` è omesso).
+- La voce del contesto di runtime si chiama `date-wrapper:date` con order `116` (già occupati: 110 sandbox, 115 approval, 120 subagent).
+- Il plugin **non esporta alcun `Config` schemastery**, quindi la sua configurazione salta la validazione dello schema dell'host; tutto è validato a mano in `validateConfig()`. Ecco anche perché la pagina Settings → Plugins non ha un form di configurazione per esso.
+
+## On/off: l'attivazione del plugin è l'interruttore, non esiste un toggle nel pannello
+
+Il plugin non include **né** un toggle nel pannello impostazioni **né** un campo di configurazione `enabled`, perché:
+
+- L'interruttore di funzione *è* lo stato attivo della riga del plugin. Inattiva → `apply()` non viene mai eseguito → la voce del contesto di runtime non esiste → non viene iniettato nemmeno un carattere.
+- Non c'è metà browser (`dsh.client`), quindi l'UI non possiede alcun widget nostro.
+- La pagina **Settings → Plugins** integrata in DSH mostra già ogni voce come `enabled / disabled` (sola lettura).
+
+### Come disattivarlo
+
+Sovrascrivetelo per `id` nel **vostro** layer di patch del profilo — `C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml`:
+
+```yaml
+- id: date-wrapper
+  disabled: true    # disabled; set back to false to restore
+```
+
+- **A caldo, senza riavvio**: il file è sorvegliato dall'HMR di Cordis e `disabled: true` dispose direttamente la fiber della riga.
+- Se la riga `date-wrapper` non esiste ancora (non installato), questa patch si limita a registrare un avviso `entry "date-wrapper" not found`; l'avvio riesce comunque.
+- ⚠️ Il file deve essere un **array YAML di primo livello**; se è malformato, **l'avvio fallisce** (DSH è fail-loud per i layer di patch utente).
+
+### Come rimuoverlo completamente
+
+```bash
+dsh plugin --profile web remove dsh-date-wrapper
+```
+
+La rimozione passa per il layer bundle e **richiede un riavvio** di dsh web (le patch bundle non fanno hot-reload).
+
+## Installazione
+
+```bash
+dsh plugin --profile web add github:drscrewdriver/dsh-date-wrapper
+```
+
+Riavviate dsh web e ricaricate la pagina. Percorsi locali, modalità link e risoluzione dei problemi: [INSTALL.it.md](./INSTALL.it.md).
+
+## Verifica
+
+| # | Come | Atteso |
+|---|-----|----------|
+| A1 | Aprire una nuova sessione e inviare un messaggio | Lo snapshot del contesto di runtime contiene `Current date: YYYY-MM-DD <zone> <weekday>` (mostrato come una riga di contesto iniettato proveniente da `system-prompt`) |
+| A2 | Controllare quella riga | ≤50 caratteri (46 misurati; la soglia PRD di 30 è stata rilassata per il formato richiesto) |
+| A3 | Disattivare il plugin (patch del profilo `disabled: true`) | La riga non compare più negli snapshot delle sessioni successive |
+| A4 | Cercare nel log di sessione | Nessun `Time sampled` / `Elapsed since` / `Browser time zone` |
+| A5 | Impostare `timeZone` su `UTC` e riavviare | La data segue UTC (può differire di un giorno a cavallo di un confine di zona) |
+
+## Note di implementazione
+
+```
+dsh-date-wrapper/
+├── package.json          # name / type: module / main / exports["."] / dsh.bundle.patch / files
+├── cordis.patch.yml      # one insert row (no patch-level id → lands at the profile root = host plane)
+├── src/
+│   ├── format.js         # pure functions: resolveZone / renderDate / createDateContextText / validateConfig / TEXT_LABEL
+│   └── index.js          # apply(ctx, config) → ctx.inject(['systemPrompt'], …) → systemPrompt.context(...)
+└── tests/
+    ├── format.test.mjs   # 11 cases (zone projection, weekday, format and length, degradation, config validation)
+    └── context.test.mjs  # 7 cases (registration contract against a fake ctx)
+```
+
+- **Riga lato host**: `ctx.inject(['systemPrompt'], …)` apre una fiber figlia; se il servizio manca, il plugin non registra nulla in silenzio invece di far fallire l'intero boot.
+- **Provider di testo fail-soft**: un'eccezione durante l'assemblaggio del prompt farebbe fallire **ogni** richiesta; un errore di rendering restituisce quindi una stringa vuota (la piattaforma filtra il testo vuoto).
+- **Niente `complete`**: impostarlo oscurerebbe l'intero system prompt.
+- **La deduplica è compito della piattaforma**: non viene mantenuto alcuno stato per agente; a cavallo della mezzanotte lo snapshot porta semplicemente la nuova data.
+- **Ciclo di vita**: la registrazione appartiene alla fiber figlia di `ctx.inject` e viene recuperata quando il plugin viene disattivato.
+
+## Sviluppo: TDD + lint
+
+```bash
+npm install          # devDependencies only (eslint / @eslint/js); zero runtime dependencies
+
+npm run tdd          # watch mode: rerun on src/ or tests/ changes (node --test --watch)
+npm test             # one full run: node --test "tests/*.test.mjs"
+node tests/format.test.mjs   # run a single file (most reliable under a sandbox: no child process)
+
+npm run lint         # eslint . (src + tests + eslint.config.mjs)
+npm run lint:fix     # auto-fix what can be fixed
+npm run verify       # lint + test; run this before committing
+```
+
+### Red-green-refactor
+
+I casi di test corrispondono direttamente ai criteri di accettazione: prima si scrive un'asserzione che fallisce, poi la si fa passare.
+
+| Passo | Azione | Comando |
+|------|--------|---------|
+| 1 rosso | Aggiungere in `tests/*.test.mjs` un'asserzione intitolata al criterio di accettazione, che affermi un comportamento che **non** avete ancora | `npm run tdd` |
+| 2 verde | Scrivere in `src/` l'implementazione minima per farla passare, senza toccare le altre asserzioni | `npm run tdd` |
+| 3 refactor | Rinominare ed estrarre funzioni pure restando nel verde; `src/format.js` contiene tutta la logica pura, `src/index.js` si limita a registrare | `npm run tdd` |
+| 4 gate | Eseguire lint + la suite completa prima di fare commit | `npm run verify` |
+
+Oggi 18 asserzioni: `format.test.mjs` (11) copre le funzioni pure, `context.test.mjs` (7) asserisce il contratto di registrazione contro uno ctx finto.
+
+### Punti salienti della configurazione lint
+
+- ESLint 10 flat config (`eslint.config.mjs`) con `@eslint/js` recommended come baseline.
+- Regole inasprite: `eqeqeq`, `prefer-const`, `object-shorthand`, `no-unused-vars` (prefisso `_` esente).
+- Le global Node `crypto` / `console` / `process` sono dichiarate esplicitamente, altrimenti `no-undef` dà falsi positivi.
+
+## Limitazioni note
+
+- **Inattivo con i preset a prompt fisso**: se la persona di un preset imposta `includeRuntimeContext: false` (lo fanno sia il `minimal` ufficiale sia il `simple-reply` locale), `assemble()` restituisce `contexts: []` e la voce di questo plugin viene scartata in blocco. Quei preset sono pensati per vietare ai listener successivi di aggiungere qualsiasi cosa al prompt.
+- **I vecchi snapshot restano nella cronologia**: quando la data cambia la piattaforma aggiunge un nuovo snapshot (quello vecchio resta) e il nuovo fa effetto tramite la sua dichiarazione "This snapshot supersedes earlier runtime-context snapshots" — allo stesso modo con cui la piattaforma gestisce i cambi di cwd / sandbox / policy di approvazione.
+- **Le patch bundle non fanno hot-reload**: modificare `cordis.patch.yml` o aggiornare il plugin richiede un riavvio di dsh web (cambiare `disabled` nella patch del profilo è a caldo).
+- **`dsh-time-context` non viene né caricato né filtrato**: se lo montate esplicitamente in un preset, il suo testo verboso appare come al solito. Non usare entrambi.
+- **Nessuna sonda a runtime per il punto di contratto**: `systemPrompt.context` è chiamato senza protezioni, quindi un futuro rinomina da parte di DSH si manifesterebbe come un fallimento di caricamento del plugin invece che come un degrado silenzioso (vedi `HANDOVER.md` §7).
+
+## Licenza
+
+MIT

package/README.ja.md

@@ -4,13 +4,28 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
 
 > 最小限の日付行です。DSH がすでに送信しているランタイムコンテキストスナップショットに `Current date: 2026-09-08 Asia/Shanghai Tuesday`（46文字、約12トークン）をぶら下げるだけです。
 > `@deepseek-ai/dsh-time-context` を**読み込まず**、余分なセッションメッセージを**追加せず**、DSH のソースを**パッチせず**、PR も必要ありません。
@@ -18,6 +33,11 @@
 - [動作原理: DSH のセッション、JSONL、リクエスト組み立て](./docs/dsh-session-and-context-mechanics.md)（中国語）
 - [HANDOVER.md](./HANDOVER.md)（中国語）
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **対応する DSH ホスト:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2`（0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 の 15 rc）
+- **ランタイム検証済み:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`（証跡は `.compat-results/`）
+<!-- host-compat:end -->
+
 ## このプラグインが解決する課題
 
 DSH 自身の `@deepseek-ai/dsh-time-context` は、リクエストごとに約 **280文字** のメタデータを注入します:
@@ -46,22 +66,26 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 | 項目 | 判定 |
 |------|---------|
-| 対象 DSH バージョン | 0.1.0-rc.7 → 0.1.3-alpha.2（コントラクトは安定。下の表を参照） |
+| 対象 DSH バージョン | スクリプト管理の列挙 — `scripts/hosts.mjs`（0.1.0 → 0.2.0 の 6 ライン計 15 rc）。ランタイム検証済みリストは冒頭の自動生成ブロックを参照 |
 | settings API | **該当なし**: プラグインは設定を登録せず、schemastery の `Config` もエクスポートしません |
 | 使用しているコントラクトポイント | ちょうど 1 つ — `systemPrompt.context()` |
 | ネイティブ機能との競合 | `@deepseek-ai/dsh-time-context` と重複します。**両方を同時に使わないでください**。デフォルトではインストールされない = デフォルトでオフ |
 | ブラウザ側 | **なし**: スロットも DOM も CSS セマンティックトークンもありません |
 | DSH パッケージのインポート | **ゼロ**: `@deepseek-ai/*` から何も取り込みません。これは「実行時検出 + デュアル API フォールバック」パターンよりも厳格です |
 
-| コントラクトポイント | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 |
-|---|---|---|---|---|
-| `systemPrompt.context(ctx): () => void` | yes | yes（このホストで検証済み） | yes | yes |
-| `PromptContext = { name, order, text }`、`complete` フィールドなし | yes | yes | yes | yes |
-| `includeRuntimeContext` / `suppressRuntimeContext` | yes | yes | yes | yes |
-| agent-loop の `project()` によるテキスト重複排除と `surfaceOp: "append"` | yes | yes | yes | 未比較 |
+歴史的静的監査（npm pack 型比較、記録用。**バージョン対応の宣言は列挙 + ランタイム行列が優先され、この表は参照用**）:
+
+| コントラクトポイント | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
+|---|---|---|---|---|---|---|
+| `systemPrompt.context(ctx): () => void` | yes | yes（このホストで検証済み） | yes | yes | yes | yes（0.1.7-rc.2 との差分はバージョン文字列のみ） |
+| `PromptContext = { name, order, text }`、`complete` フィールドなし | yes | yes | yes | yes | yes | yes |
+| `includeRuntimeContext` / `suppressRuntimeContext` | yes | yes | yes | yes | yes | yes |
+| agent-loop の `project()` によるテキスト重複排除と `surfaceOp: "append"` | yes | yes | yes | 未比較 | yes | yes |
+| `order: 116` の衝突なし（110 / 115 / 120 は使用中） | yes | yes | yes | yes | yes | yes |
 
 > 方法: `npm pack @deepseek-ai/dsh-system-prompt@<version>` で取得して展開し、`lib/types/index.d.ts` と `lib/index.js` を比較。`@deepseek-ai/dsh-agent-loop` も同様。
-> このホストで**実行時に**検証済みなのは 0.1.1-rc.2 のみです。0.1.2-rc.1 / 0.1.3-alpha.2 の実行時検証はまだ保留中です（`HANDOVER.md` §7 を参照）。
+> `dsh-v0.1.7-rc.2` と `dsh-v0.2.0-rc.1` の間で `packages/core/system-prompt` の差分はバージョン 1 行のみで、110/115/120 の `systemPrompt.context` 呼び出し箇所はそのまま、プラグイン移行ガイドに `systemPrompt` の項目はありません。
+> ランタイム検証は現在、ホスト rc ごとに**ローカル分離マトリクス**で実施します（`scripts/test-host-compat.mjs`、証跡は `.compat-results/`）。グリーンリストは冒頭の自動生成ブロックです。`HANDOVER.md` §7 の 0.1.1-rc.2 の記録はマトリクス以前のものです。
 
 ## メッセージではなくランタイムコンテキストスナップショットを使う理由
 

package/README.ko.md

@@ -4,13 +4,28 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation](./INSTALL.fr.md)
+- [Installationsanleitung](./INSTALL.de.md)
+- [Guida all'installazione](./INSTALL.it.md)
+- [Руководство по установке](./INSTALL.ru.md)
+- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
 
 > 최소한의 날짜 한 줄: DSH가 이미 전송하고 있는 런타임 컨텍스트 스냅샷에 `Current date: 2026-09-08 Asia/Shanghai Tuesday`(46 characters, ~12 tokens)를 얹습니다.
 > `@deepseek-ai/dsh-time-context`를 로드하지 **않고**, 추가 세션 메시지를 넣지 **않으며**, DSH 소스를 패치하지 **않고**, PR도 필요하지 않습니다.
@@ -18,6 +33,11 @@
 - [동작 원리: DSH 세션, JSONL, 요청 조립](./docs/dsh-session-and-context-mechanics.md) (중국어)
 - [HANDOVER.md](./HANDOVER.md) (중국어)
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **지원하는 DSH 호스트:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 라인의 15개 rc)
+- **런타임 검증됨:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` (증적은 `.compat-results/`)
+<!-- host-compat:end -->
+
 ## 이 플러그인이 해결하는 문제
 
 DSH 자체의 `@deepseek-ai/dsh-time-context`는 매 요청마다 약 **280 characters**의 메타데이터를 주입합니다:
@@ -46,22 +66,26 @@ Current date: 2026-09-08 Asia/Shanghai Tuesday
 
 | 항목 | 판정 |
 |------|---------|
-| 대상 DSH 버전 | 0.1.0-rc.7 → 0.1.3-alpha.2 (계약 안정, 아래 표 참조) |
+| 대상 DSH 버전 | 스크립트 관리 열거 — `scripts/hosts.mjs` (0.1.0 → 0.2.0 6개 라인 총 15개 rc). 런타임 검증 목록은 문서 상단 자동 생성 블록 참조 |
 | settings API | **해당 없음**: 이 플러그인은 settings를 등록하지 않고 schemastery `Config`도 내보내지 않습니다 |
 | 사용하는 계약 지점 | 정확히 하나 — `systemPrompt.context()` |
 | 네이티브 기능과의 충돌 | `@deepseek-ai/dsh-time-context`와 중복됩니다; **둘 다 사용하지 마십시오**. 기본 미설치 = 기본 꺼짐 |
 | 브라우저 절반 | **없음**: 슬롯 없음, DOM 없음, CSS 시맨틱 토큰 없음 |
 | DSH 패키지 임포트 | **0건**: `@deepseek-ai/*`에서 아무것도 가져오지 않으며, 이는 "런타임 감지 + 이중 API 폴백" 패턴보다 더 엄격합니다 |
 
-| 계약 지점 | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 |
-|---|---|---|---|---|
-| `systemPrompt.context(ctx): () => void` | 예 | 예(이 호스트에서 검증됨) | 예 | 예 |
-| `PromptContext = { name, order, text }`, `complete` 필드 없음 | 예 | 예 | 예 | 예 |
-| `includeRuntimeContext` / `suppressRuntimeContext` | 예 | 예 | 예 | 예 |
-| agent-loop의 `project()` 텍스트 중복 제거와 `surfaceOp: "append"` | 예 | 예 | 예 | 비교하지 않음 |
+역사적 정적 감사(npm pack 타입 비교, 기록용. **버전 지원 선언은 열거 + 런타임 매트릭스가 우선하며 이 표는 참조용**):
+
+| 계약 지점 | 0.1.0-rc.7 | 0.1.1-rc.2 | 0.1.2-rc.1 | 0.1.3-alpha.2 | 0.1.7-rc.2 | 0.2.0-rc.1 |
+|---|---|---|---|---|---|---|
+| `systemPrompt.context(ctx): () => void` | 예 | 예(이 호스트에서 검증됨) | 예 | 예 | 예 | 예(0.1.7-rc.2 대비 diff는 버전 문자열 1줄뿐) |
+| `PromptContext = { name, order, text }`, `complete` 필드 없음 | 예 | 예 | 예 | 예 | 예 | 예 |
+| `includeRuntimeContext` / `suppressRuntimeContext` | 예 | 예 | 예 | 예 | 예 | 예 |
+| agent-loop의 `project()` 텍스트 중복 제거와 `surfaceOp: "append"` | 예 | 예 | 예 | 비교하지 않음 | 예 | 예 |
+| `order: 116` 충돌 없음(110 / 115 / 120 사용 중) | 예 | 예 | 예 | 예 | 예 | 예 |
 
 > 방법: `npm pack @deepseek-ai/dsh-system-prompt@<version>`으로 묶은 뒤 풀고 `lib/types/index.d.ts`와 `lib/index.js`를 비교합니다; `@deepseek-ai/dsh-agent-loop`도 같은 방식입니다.
-> 이 호스트에서 **런타임에서** 검증된 것은 0.1.1-rc.2뿐이며, 0.1.2-rc.1 / 0.1.3-alpha.2의 런타임 검증은 아직 대기 중입니다(`HANDOVER.md` §7 참조).
+> `dsh-v0.1.7-rc.2`와 `dsh-v0.2.0-rc.1` 사이 `packages/core/system-prompt`의 diff는 버전 1줄뿐이고, 110/115/120의 `systemPrompt.context` 호출 지점은 그대로이며, 플러그인 마이그레이션 가이드에는 `systemPrompt` 항목이 없습니다.
+> 런타임 검증은 이제 호스트 rc별로 **로컬 격리 매트릭스**에서 수행합니다(`scripts/test-host-compat.mjs`, 증적은 `.compat-results/`). 그린 리스트는 문서 상단 자동 생성 블록입니다. `HANDOVER.md` §7의 0.1.1-rc.2 기록은 매트릭스 이전의 것입니다.
 
 ## 메시지가 아니라 런타임 컨텍스트 스냅샷인 이유