dsh-plugin-upgrade 0.1.3 → 2.0.0

package/types.d.ts

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Public type surface for dsh-plugin-upgrade.
  * @module dsh-plugin-upgrade
@@ -7,7 +8,7 @@
 export interface Config {
   /** Register the packaged skill (default true). */
   enabled?: boolean
-  /** Skill name published to the model catalog (default 'plugin-upgrade-015'). */
+  /** Skill name published to the model catalog (default 'plugin-upgrade'). */
   skillName?: string
   /** Skill root inside the package; must contain `<skillName>/SKILL.md`. */
   skillsRoot?: string
@@ -15,19 +16,28 @@ export interface Config {
   userInvocable?: boolean
 }
 
+/**
+ * The merged seam-id union: leg A `S1`–`S10` + `M1`, leg B `C1`, `C2`, `C4`,
+ * `C5`, `H1`–`H4`, `P1`. Leg B's former `C3` is leg A's `M1` and is **not** a
+ * member: the scanner, `--seams` and the card index all reject it.
+ */
+export type SeamId =
+  | 'S3' | 'S8' | 'S9' | 'M1' | 'S4' | 'S5' | 'S6' | 'S7' | 'S2' | 'S1' | 'S10'
+  | 'C1' | 'C2' | 'P1' | 'C4' | 'C5' | 'H1' | 'H2' | 'H4' | 'H3'
+
 /** One seam hit produced by the scanner. */
 export interface SeamHit {
-  /** Seam id: S1..S10 or M1. */
-  seam: string
-  /** 'error' fails the scan; 'warn' is a manual-review lead. */
-  severity: 'error' | 'warn'
+  /** Seam id, one of the merged 20 (`S3`, `S8`, `S9`, `M1`, `S4`, `S5`, `S6`, `S7`, `S2`, `S1`, `S10`, `C1`, `C2`, `P1`, `C4`, `C5`, `H1`, `H2`, `H4`, `H3`). */
+  seam: SeamId
+  /** 'error' fails the scan; 'warn' and 'info' are manual-review leads. */
+  severity: 'error' | 'warn' | 'info'
   /** Absolute path of the file carrying the hit. */
   file: string
   /** 1-based line number. */
   line: number
   /** Trimmed source line (truncated to 200 characters). */
   snippet: string
-  /** Human-readable explanation, including the suggested action for M1. */
+  /** Human-readable explanation, including the suggested action. */
   detail: string
 }
 
@@ -40,7 +50,20 @@ export interface ScanReport {
   bySeam: Record<string, number>
 }
 
-/** Scan a repository directory for the 0.1.3-alpha.1 -> 0.1.5-alpha.1 seams. */
+/**
+ * One entry of the seam catalog shared by the card, the CLI and the plugin.
+ * `test` is null for a card-only seam (`H3`) and for the two structured seams
+ * (`M1`, `P1`), which run dedicated file-level detectors instead of a regex.
+ */
+export interface Seam {
+  id: SeamId
+  title: string
+  severity: 'error' | 'warn' | 'info'
+  action: string
+  test: RegExp | null
+}
+
+/** Scan a repository directory for the merged 0.1.3-alpha.1 -> 0.1.5-rc.1 seams. */
 export declare function scanRepo(repoDir: string, options?: { seams?: string[] }): ScanReport
 
 /** Render a report for a terminal. */
@@ -49,6 +72,15 @@ export declare function render(report: ScanReport): string
 /** CLI entry point; returns the process exit code. */
 export declare function main(argv: string[]): number
 
+/** The seam catalog. The version card must name exactly these ids. */
+export declare const SEAMS: Seam[]
+
+/** Seam ids in card order; `test/card.test.mjs` pins the card to this list. */
+export declare const SEAM_IDS: SeamId[]
+
+/** Seams documented on the card with no automatic detection (`H3`). */
+export declare const CARD_ONLY: SeamId[]
+
 /** Split a SKILL.md frontmatter block into its routing fields and body. */
 export declare function splitFrontmatter(text: string): { description?: string, whenToUse?: string, body: string }
 

package/README.es.md

@@ -1,172 +0,0 @@
-<div align="center">
-
-# ⬆️ dsh-plugin-upgrade
-- **Canal de la tienda 1024**: ejecuta `npm i -g dsh1024` una vez y luego `dsh1024 plugin --profile web add dsh-plugin-upgrade` (cuenta para el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com)).
-[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-plugin-upgrade)
-
-**Habilidad de actualización de plugins con versión fijada para DeepSeek Harness — `0.1.3-alpha.1` → `0.1.5-alpha.1`.**
-
-*Una tarjeta de versión más un escáner de costuras sin dependencias, para que «typecheck está en verde» nunca se confunda con «el plugin sigue funcionando».*
-
-> **Repositorio oficial.** Este es el único repositorio oficial de dsh-plugin-upgrade, mantenido por PerryLink. Los repositorios con el mismo nombre en otras cuentas no están afiliados.
-
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
-[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-plugin-upgrade.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
-[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-upgrade/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-plugin-upgrade/actions)
-[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-plugin-upgrade?label=version)](https://github.com/PerryLink/dsh-plugin-upgrade/releases)
-[![npm version](https://img.shields.io/npm/v/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-
-[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
-
-</div>
-
----
-
-## Compatibilidad
-
-| Superficie | Estado |
-|---|---|
-| Harness | DeepSeek Harness `0.1.5-rc.1` (checkout `2efea31131`, tag `dsh-v0.1.5-rc.1` = `183f08e9c6dd`). Banda de peers `@deepseek-ai/dsh-skill >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0`, `@deepseek-ai/cordis ^4.0.2`, `@deepseek-ai/schemastery ^3.18.2`. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
-| Plataformas | Donde corra Node; el escáner solo lee el sistema de archivos y es neutral respecto a la plataforma |
-| Modelo | Modelos solo de texto totalmente soportados; la habilidad es un cuerpo Markdown, sin requisitos de herramientas ni visión |
-| Alcance | **Un solo corredor**: `0.1.3-alpha.1` → `0.1.5-alpha.1`. No es un marco de migración general. |
-
-## Lo que obtienes
-
-Dos mitades y un único catálogo de costuras:
-
-- **Una habilidad de agente incluida (`plugin-upgrade-015`)**: una tarjeta de versión y un bucle de corregir-y-verificar. El modelo solo la carga cuando la tarea realmente la necesita; el paquete no aporta ningún párrafo al prompt del sistema ni registra herramientas.
-- **Una CLI sin dependencias (`dsh-plugin-upgrade-scan`)**: informa hechos `archivo:línea` para diez costuras medidas sobre 40 repositorios de plugins reales durante la ola de adaptación del 2026-09-09. Sale con `1` ante cualquier hallazgo de severidad error, así que entra directo en CI.
-
-El objetivo es el modo de fallo que la tarjeta existe para eliminar: **una puerta local en verde no es prueba de adaptación.** Dos clases de rotura sobreviven a `typecheck` + `test`:
-
-1. la línea de tipos publicada oculta la costura y el repositorio compila contra tipos obsoletos (costura `M1`);
-2. las pruebas están simuladas contra la forma antigua, así que pasan mientras el host rechaza la nueva.
-
-Cuatro de las diez costuras — `S3`, `S8`, `S9`, `M1` — seguían sin cobertura por ningún PR comunitario de actualización cuando se escribió este paquete; las otras seis están contrastadas con la evidencia de la ola.
-
-## Inicio rápido
-
-```sh
-# 1. instala el bundle en tu perfil
-dsh plugin --profile web add dsh-plugin-upgrade
-
-# 2. verifica que la fila se montó
-dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-upgrade'
-
-# 3. escanea el plugin que estás actualizando
-npx dsh-plugin-upgrade-scan --repo ../my-plugin
-```
-
-Después pide al agente que use la habilidad `plugin-upgrade-015`, o guía el bucle tú mismo con la tarjeta en
-`skills/plugin-upgrade-015/references/v0.1.3-alpha.1-to-v0.1.5-alpha.1.md`.
-
-## Instalación y desinstalación
-
-```sh
-dsh plugin --profile web add dsh-plugin-upgrade            # desde npm
-dsh plugin --profile web add "github:PerryLink/dsh-plugin-upgrade#main"   # desde el código
-dsh plugin --profile web remove dsh-plugin-upgrade         # desinstalar (reversible)
-```
-
-Instalar el bundle solo registra una habilidad; quitar la fila la elimina. La CLI es un destino `npx` normal y no necesita ningún perfil.
-
-## Configuración
-
-Cada clave es opcional y vive en el patch del perfil:
-
-| Clave | Predeterminado | Significado |
-|---|---|---|
-| `enabled` | `true` | Registra la habilidad incluida. `false` mantiene la dependencia montada pero silenciosa. |
-| `skillName` | `plugin-upgrade-015` | Directorio bajo `skillsRoot` que se registra, y nombre mostrado en el catálogo. |
-| `skillsRoot` | el `./skills` del propio paquete | Dónde vive `<skillName>/SKILL.md`. Apúntalo a tu propia tarjeta para reutilizar la infraestructura. |
-| `userInvocable` | `true` | Si una persona puede invocar la habilidad por nombre además del modelo. |
-
-```yaml
-- insert:
-    - id: dsh-plugin-upgrade
-      name: dsh-plugin-upgrade
-      config:
-        skillName: plugin-upgrade-015
-```
-
-El montaje falla en voz alta: un `SKILL.md` ausente, un cuerpo vacío o un frontmatter sin `name` abortan el montaje en lugar de registrar una habilidad vacía.
-
-## Superficies
-
-**Habilidad** — `plugin-upgrade-015` (invocable por el modelo y por la persona por defecto). Cuerpo: el bucle de 6 pasos. Referencias: la tarjeta de versión. Scripts: el detector, incluido dentro del directorio de la habilidad para que las rutas relativas resuelvan.
-
-**CLI** — `dsh-plugin-upgrade-scan`:
-
-```sh
-dsh-plugin-upgrade-scan [--repo <path>] [--json <out.json>] [--seams S3,S8,M1] [--quiet]
-```
-
-| Bandera | Significado |
-|---|---|
-| `--repo <path>` | Repositorio a escanear (predeterminado: cwd). |
-| `--json <out.json>` | Escribe además el informe legible por máquina (`repo`, `scannedAt`, `files`, `hits[]`, `bySeam`). |
-| `--seams S3,S8,M1` | Restringe a costuras concretas. |
-| `--quiet` | Silencia la salida humana (combínala con `--json`). |
-
-Códigos de salida: `0` sin hallazgos de severidad error · `1` al menos uno · `2` uso o fallo de escaneo. Un escaneo limpio es necesario pero no suficiente: el criterio de salida de la tarjeta es una prueba real en un `DSH_HOME` temporal.
-
-## Las diez costuras
-
-| Id | Severidad | Qué cambió en la línea `0.1.5-alpha.1` |
-|---|---|---|
-| `S1` | warn | El formato de sesión es V3; el archivo de log lleva generación (`session.v3.jsonl.zstd`). Las rutas fijas a `session.jsonl.zstd` dejan de funcionar en silencio. |
-| `S2` | warn | `EpochHeader.system` desapareció; el prompt del sistema es `system/message` en el nodo 0 de la superficie. Los lectores necesitan un respaldo estructural. |
-| `S3` | error | `assistant/message` requiere `stream`; sin él la sesión se importa pero no se puede reanudar (`Session.fromRestore` rechaza campos de settlement inválidos). |
-| `S4` | error | `tool/code-dispatch` pasó a llamarse `tool/ptc-dispatch`. |
-| `S5` | error | `ctx.agent` se eliminó; los llamadores reciben el `Agent` explícitamente. |
-| `S6` | error | `Inbox` pasó a ser una interfaz de tipo: ya no se puede construir; usa `agent.inbox` y la forma oficial del fixture. |
-| `S7` | warn | `SubprocessHandle.pid` se eliminó (solo `SubprocessTerminalHandle` conserva `pid`). |
-| `S8` | error | `SessionHandle.read()` ahora devuelve `SessionHandleReadResult`: desenvuelve `.events`. |
-| `S9` | error | La configuración `persona` de `SystemPrompt` pasó a `personaPrefix` / `personaSuffix`. |
-| `M1` | error | Un alias `paths` de `tsconfig` que apunta a un directorio inexistente hace que TypeScript vuelva en silencio a los tipos publicados: la puerta local se vuelve **falsamente verde**. |
-
-`S7`, `S1`, `S2` y `S10` son deliberadamente informativos: tienen coincidencias legítimas (el `pid` de Node, lectores de generaciones antiguas, la propia puerta de eventos adaptativa de un plugin), así que el escáner los reporta como pistas para revisión manual y no como fallos.
-
-## Lo que esto no cubre
-
-- **Otros corredores.** `0.1.1` → `0.1.2` y líneas futuras quedan fuera; la tarjeta está fijada a propósito, porque una tarjeta que se desvía es peor que ninguna.
-- **La ruta de actualización de DSH para usuarios.** Este paquete actualiza el **código fuente del plugin**, no la instalación del harness de un usuario.
-- **Comportamiento de cliente/navegador.** El escáner es estático; una mitad cliente aún necesita una aserción real en el navegador.
-- **Prueba.** Un escaneo limpio es una hipótesis. El criterio de salida es una prueba real en el host (`DSH_HOME` temporal, CLI objetivo, `plugin add <tarball>`, `--dump-config`, más una ida y vuelta de resume para quien escribe logs de sesión).
-
-## Límites de seguridad
-
-- **Escaneo de solo lectura.** La CLI nunca escribe dentro del repositorio escaneado; `--json` escribe solo en la ruta que le indiques.
-- **Sin red ni shell.** El escáner no importa nada fuera de la biblioteca estándar de Node y nunca lanza procesos.
-- **Sin secretos.** Nada en el paquete lee credenciales, tokens de entorno ni datos de sesión.
-- **Receta de prueba en sandbox.** La comprobación real de la tarjeta usa un `DSH_HOME` creado con `mkdtemp`; nunca toca tu `~/.dsh` real.
-
-## Desarrollo
-
-```sh
-pnpm install
-pnpm test                          # node --test (Cordis real + SkillRegistry real)
-pnpm run verify:self-contained     # cada import resuelve dentro del paquete
-pnpm run verify:artifacts          # el tarball incluye la habilidad, la CLI y el patch
-pnpm run check:readmes             # consistencia de los README en cinco idiomas
-pnpm pack
-```
-
-El escáner trae sus propios `fixtures/bad-repo` y `fixtures/good-repo` sintéticos, más un negativo en vivo sobre un repositorio ya adaptado por la ola, de modo que una regresión en el catálogo falla la suite en lugar de llegar a un usuario.
-
-## Temas
-
-`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-upgrade`, `migration`, `skill`, `version-card`, `scanner` (reflejan las keywords de `package.json`; `dsh-plugin` es el canal de visibilidad del ecosistema).
-
-## Familia de plugins DSH de PerryLink
-
-Parte de la familia de plugins DSH de PerryLink: 40 repositorios que cubren sesiones, memoria, permisos, entrega, observabilidad y herramientas para desarrolladores. Explora el catálogo en [perrylink-dsh-catalog.perrylink.workers.dev](https://perrylink-dsh-catalog.perrylink.workers.dev) o el [tema `dsh-plugin`](https://github.com/topics/dsh-plugin).
-
-## Licencia
-
-Apache-2.0 — consulta [LICENSE](LICENSE). Las dependencias de instalación y sus licencias figuran en [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md); no se empaqueta nada de terceros.

package/README.hi.md

@@ -1,172 +0,0 @@
-<div align="center">
-
-# ⬆️ dsh-plugin-upgrade
-- **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024` चलाएँ, फिर `dsh1024 plugin --profile web add dsh-plugin-upgrade` (यह [deepseek1024.com](https://deepseek1024.com) की इंस्टॉल रैंकिंग में गिना जाता है)।
-[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-plugin-upgrade)
-
-**DeepSeek Harness के लिए संस्करण-लॉक प्लगइन अपग्रेड स्किल — `0.1.3-alpha.1` → `0.1.5-alpha.1`।**
-
-*एक संस्करण कार्ड और एक शून्य-निर्भरता सीम-स्कैनर, ताकि «typecheck हरा है» को कभी «प्लगइन अब भी चलता है» न समझा जाए।*
-
-> **आधिकारिक रिपॉज़िटरी।** यह dsh-plugin-upgrade की एकमात्र आधिकारिक रिपॉज़िटरी है, जिसे PerryLink अनुरक्षित करता है। अन्य खातों की समान-नाम वाली रिपॉज़िटरी इससे संबद्ध नहीं हैं।
-
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
-[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-plugin-upgrade.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
-[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-upgrade/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-plugin-upgrade/actions)
-[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-plugin-upgrade?label=version)](https://github.com/PerryLink/dsh-plugin-upgrade/releases)
-[![npm version](https://img.shields.io/npm/v/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-
-[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
-
-</div>
-
----
-
-## संगतता
-
-| सतह | स्थिति |
-|---|---|
-| हार्नेस | DeepSeek Harness `0.1.5-rc.1` (checkout `2efea31131`, tag `dsh-v0.1.5-rc.1` = `183f08e9c6dd`)। पीयर बैंड `@deepseek-ai/dsh-skill >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0`, `@deepseek-ai/cordis ^4.0.2`, `@deepseek-ai/schemastery ^3.18.2`। |
-| Node | `^22.19.0 \|\| >=24.0.0` |
-| प्लेटफ़ॉर्म | जहाँ Node चले; स्कैनर केवल फ़ाइल सिस्टम पढ़ता है और प्लेटफ़ॉर्म-निरपेक्ष है |
-| मॉडल | केवल-पाठ मॉडल पूरी तरह समर्थित; स्किल एक Markdown बॉडी है, किसी टूल या विज़न की आवश्यकता नहीं |
-| दायरा | **केवल एक कॉरिडोर**: `0.1.3-alpha.1` → `0.1.5-alpha.1`। यह सामान्य माइग्रेशन फ़्रेमवर्क नहीं है। |
-
-## आपको क्या मिलता है
-
-दो हिस्से, एक ही सीम-कैटलॉग:
-
-- **एक बंडल एजेंट स्किल (`plugin-upgrade-015`)** — एक संस्करण कार्ड और «ठीक करो-सत्यापित करो» चक्र। मॉडल इसे तभी लोड करता है जब कार्य को वास्तव में ज़रूरत हो; यह पैकेज सिस्टम प्रॉम्प्ट में कोई पैराग्राफ़ नहीं जोड़ता और कोई टूल पंजीकृत नहीं करता।
-- **एक शून्य-निर्भरता CLI (`dsh-plugin-upgrade-scan`)** — 2026-09-09 की अडैप्टेशन लहर में 40 वास्तविक प्लगइन रिपॉज़िटरी पर मापी गई दस सीमों के लिए `file:line` तथ्य देता है। कोई भी error-स्तर का हिट मिलने पर एग्ज़िट `1`, इसलिए यह सीधे CI में लगता है।
-
-कार्ड जिस विफलता-विधा को ख़त्म करने के लिए है वह यह है: **स्थानीय गेट का हरा होना अडैप्टेशन का प्रमाण नहीं है।** दो तरह की टूटन `typecheck` + `test` को पार कर जाती हैं:
-
-1. प्रकाशित टाइप लाइन सीम को छिपा देती है और रिपॉज़िटरी पुराने टाइप के विरुद्ध कंपाइल हो जाती है (सीम `M1`);
-2. टेस्ट पुरानी शक्ल पर मॉक किए गए हैं, इसलिए वे पास हो जाते हैं जबकि होस्ट नई शक्ल अस्वीकार करता है।
-
-दस सीमों में से चार — `S3`, `S8`, `S9`, `M1` — जब यह पैकेज लिखा गया तब तक किसी सामुदायिक अपग्रेड PR में शामिल नहीं थीं; बाक़ी छह को उस लहर के प्रमाण से मिलाया गया है।
-
-## त्वरित शुरुआत
-
-```sh
-# 1. बंडल को अपने प्रोफ़ाइल में इंस्टॉल करें
-dsh plugin --profile web add dsh-plugin-upgrade
-
-# 2. पुष्टि करें कि पंक्ति माउंट हुई
-dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-upgrade'
-
-# 3. जिस प्लगइन को अपग्रेड कर रहे हैं उसे स्कैन करें
-npx dsh-plugin-upgrade-scan --repo ../my-plugin
-```
-
-फिर एजेंट से `plugin-upgrade-015` स्किल इस्तेमाल करने को कहें, या यहाँ रखे कार्ड के साथ चक्र ख़ुद चलाएँ:
-`skills/plugin-upgrade-015/references/v0.1.3-alpha.1-to-v0.1.5-alpha.1.md`।
-
-## इंस्टॉल और अनइंस्टॉल
-
-```sh
-dsh plugin --profile web add dsh-plugin-upgrade            # npm से
-dsh plugin --profile web add "github:PerryLink/dsh-plugin-upgrade#main"   # सोर्स से
-dsh plugin --profile web remove dsh-plugin-upgrade         # अनइंस्टॉल (प्रतिवर्ती)
-```
-
-बंडल इंस्टॉल करने से केवल एक स्किल पंजीकृत होती है; पंक्ति हटाने से स्किल हट जाती है। CLI एक सामान्य `npx` लक्ष्य है और इसके लिए किसी प्रोफ़ाइल की ज़रूरत नहीं।
-
-## कॉन्फ़िगरेशन
-
-हर कुंजी वैकल्पिक है और प्रोफ़ाइल पैच में रहती है:
-
-| कुंजी | डिफ़ॉल्ट | अर्थ |
-|---|---|---|
-| `enabled` | `true` | बंडल स्किल पंजीकृत करें। `false` रखने पर निर्भरता माउंट रहती है पर चुप रहती है। |
-| `skillName` | `plugin-upgrade-015` | `skillsRoot` के अंदर पंजीकृत होने वाली डायरेक्टरी, और कैटलॉग में दिखने वाला नाम। |
-| `skillsRoot` | पैकेज का अपना `./skills` | जहाँ `<skillName>/SKILL.md` है। अपना कार्ड लगाने के लिए इसे उस ओर इंगित करें। |
-| `userInvocable` | `true` | मॉडल के अलावा इंसान भी नाम से स्किल बुला सके या नहीं। |
-
-```yaml
-- insert:
-    - id: dsh-plugin-upgrade
-      name: dsh-plugin-upgrade
-      config:
-        skillName: plugin-upgrade-015
-```
-
-माउंट ज़ोर से विफल होता है: `SKILL.md` गुम, बॉडी ख़ाली, या frontmatter में `name` न हो — तो माउंट रुक जाता है, ख़ाली स्किल पंजीकृत नहीं होती।
-
-## सतहें
-
-**स्किल** — `plugin-upgrade-015` (डिफ़ॉल्ट रूप से मॉडल और इंसान दोनों बुला सकते हैं)। बॉडी: 6-चरणीय चक्र। संदर्भ: संस्करण कार्ड। स्क्रिप्ट: डिटेक्टर, स्किल डायरेक्टरी के अंदर ही, ताकि सापेक्ष पथ हल हों।
-
-**CLI** — `dsh-plugin-upgrade-scan`:
-
-```sh
-dsh-plugin-upgrade-scan [--repo <path>] [--json <out.json>] [--seams S3,S8,M1] [--quiet]
-```
-
-| फ़्लैग | अर्थ |
-|---|---|
-| `--repo <path>` | स्कैन करने वाली रिपॉज़िटरी (डिफ़ॉल्ट: cwd)। |
-| `--json <out.json>` | मशीन-पठनीय रिपोर्ट भी लिखें (`repo`, `scannedAt`, `files`, `hits[]`, `bySeam`)। |
-| `--seams S3,S8,M1` | केवल दिए गए सीमों तक सीमित करें। |
-| `--quiet` | मानव-पठनीय आउटपुट बंद करें (`--json` के साथ)। |
-
-एग्ज़िट कोड: `0` कोई error-स्तर हिट नहीं · `1` कम से कम एक · `2` उपयोग या स्कैन विफलता। साफ़ स्कैन आवश्यक है पर पर्याप्त नहीं — कार्ड की निकास कसौटी अस्थायी `DSH_HOME` पर वास्तविक-होस्ट स्मोक है।
-
-## दस सीमें
-
-| Id | स्तर | `0.1.5-alpha.1` लाइन में क्या बदला |
-|---|---|---|
-| `S1` | warn | सेशन फ़ॉर्मैट V3 है; लॉग फ़ाइल पीढ़ी-सहित है (`session.v3.jsonl.zstd`)। कठोर कोडित `session.jsonl.zstd` चुपचाप बेकार हो जाता है। |
-| `S2` | warn | `EpochHeader.system` हट गया; सिस्टम प्रॉम्प्ट सरफ़ेस नोड 0 पर `system/message` है। पढ़ने वालों को संरचनात्मक फ़ॉलबैक चाहिए। |
-| `S3` | error | `assistant/message` में `stream` अनिवार्य है; बिना उसके सेशन इम्पोर्ट होता है पर रिज़्यूम नहीं होता (`Session.fromRestore` अमान्य settlement फ़ील्ड अस्वीकार करता है)। |
-| `S4` | error | `tool/code-dispatch` का नाम `tool/ptc-dispatch` हो गया। |
-| `S5` | error | `ctx.agent` हट गया; कॉलर को `Agent` स्पष्ट रूप से मिलता है। |
-| `S6` | error | `Inbox` अब टाइप इंटरफ़ेस है — बनाया नहीं जा सकता; `agent.inbox` और आधिकारिक फ़िक्स्चर शक्ल इस्तेमाल करें। |
-| `S7` | warn | `SubprocessHandle.pid` हट गया (केवल `SubprocessTerminalHandle` में `pid` बचा है)। |
-| `S8` | error | `SessionHandle.read()` अब `SessionHandleReadResult` लौटाता है — `.events` खोलें। |
-| `S9` | error | `SystemPrompt` का कॉन्फ़िग `persona` अब `personaPrefix` / `personaSuffix` है। |
-| `M1` | error | `tsconfig` का `paths` ऐसी डायरेक्टरी ओर इंगित हो जो मौजूद नहीं, तो TypeScript चुपचाप प्रकाशित टाइप पर लौट जाता है — स्थानीय गेट **झूठा हरा** बन जाता है। |
-
-`S7`, `S1`, `S2` और `S10` जान-बूझकर सूचनात्मक हैं: इनके वैध मेल भी होते हैं (Node का अपना `pid`, पुरानी पीढ़ी के रीडर, प्लगइन का अपना अडैप्टिव इवेंट गेट), इसलिए स्कैनर इन्हें मैनुअल समीक्षा के सुराग़ बतौर दिखाता है, विफलता नहीं।
-
-## यह क्या कवर नहीं करता
-
-- **अन्य कॉरिडोर।** `0.1.1` → `0.1.2` और आगे की लाइनें दायरे से बाहर; कार्ड जान-बूझकर लॉक है, क्योंकि बहकने वाला कार्ड न होने से बुरा है।
-- **DSH का उपयोगकर्ता-मुखी अपग्रेड पथ।** यह पैकेज **प्लगइन सोर्स कोड** अपग्रेड करता है, उपयोगकर्ता की harness इंस्टॉलेशन नहीं।
-- **क्लाइंट/ब्राउज़र व्यवहार।** स्कैनर स्थिर है; क्लाइंट आधे हिस्से के लिए असली ब्राउज़र जाँच चाहिए।
-- **प्रमाण।** साफ़ स्कैन एक परिकल्पना है। निकास कसौटी वास्तविक-होस्ट स्मोक है (अस्थायी `DSH_HOME`, लक्ष्य CLI, `plugin add <tarball>`, `--dump-config`, और सेशन-लॉग लिखने वालों के लिए एक resume राउंड-ट्रिप)।
-
-## सुरक्षा सीमाएँ
-
-- **केवल-पठन स्कैन।** CLI स्कैन की गई रिपॉज़िटरी के अंदर कभी नहीं लिखता; `--json` केवल आपके दिए पथ पर लिखता है।
-- **कोई नेटवर्क, कोई शेल नहीं।** स्कैनर Node की मानक लाइब्रेरी के अलावा कुछ आयात नहीं करता और कभी प्रोसेस नहीं बनाता।
-- **कोई रहस्य नहीं।** पैकेज में कुछ भी क्रेडेंशियल, एनवायरनमेंट टोकन या सेशन डेटा नहीं पढ़ता।
-- **सैंडबॉक्स स्मोक नुस्ख़ा।** कार्ड की असली-होस्ट जाँच `mkdtemp` वाले `DSH_HOME` का उपयोग करती है; आपके असली `~/.dsh` को कभी नहीं छूती।
-
-## विकास
-
-```sh
-pnpm install
-pnpm test                          # node --test (असली Cordis + असली SkillRegistry)
-pnpm run verify:self-contained     # हर import पैकेज के भीतर हल होता है
-pnpm run verify:artifacts          # tarball में स्किल, CLI और patch मौजूद
-pnpm run check:readmes             # पाँच-भाषा README एकरूपता
-pnpm pack
-```
-
-स्कैनर के साथ संश्लेषित `fixtures/bad-repo` और `fixtures/good-repo` हैं, और लहर से पहले ही अडैप्ट हो चुकी रिपॉज़िटरी पर एक live negative भी — इसलिए कैटलॉग में रिग्रेशन टेस्ट सूट को गिराता है, उपयोगकर्ता तक नहीं पहुँचता।
-
-## विषय टैग
-
-`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-upgrade`, `migration`, `skill`, `version-card`, `scanner` (`package.json` की keywords के अनुरूप; `dsh-plugin` पारिस्थितिकी का दृश्यता चैनल है)।
-
-## PerryLink DSH प्लगइन परिवार
-
-यह PerryLink DSH प्लगइन परिवार का हिस्सा है — 40 रिपॉज़िटरी, जो सेशन, मेमोरी, अनुमतियाँ, डिलीवरी, ऑब्ज़र्वेबिलिटी और डेवलपर टूलिंग कवर करती हैं। कैटलॉग देखें [perrylink-dsh-catalog.perrylink.workers.dev](https://perrylink-dsh-catalog.perrylink.workers.dev) पर या [`dsh-plugin` टॉपिक](https://github.com/topics/dsh-plugin) पर।
-
-## लाइसेंस
-
-Apache-2.0 — देखें [LICENSE](LICENSE)। इंस्टॉल-समय की निर्भरताएँ और उनके लाइसेंस [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) में सूचीबद्ध हैं; कुछ भी बंडल नहीं किया गया।

package/README.pt.md

@@ -1,172 +0,0 @@
-<div align="center">
-
-# ⬆️ dsh-plugin-upgrade
-- **Canal da loja 1024**: rode `npm i -g dsh1024` uma vez e depois `dsh1024 plugin --profile web add dsh-plugin-upgrade` (conta para o ranking de instalações do [deepseek1024.com](https://deepseek1024.com)).
-[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-plugin-upgrade)
-
-**Skill de upgrade de plugins com versão fixada para o DeepSeek Harness — `0.1.3-alpha.1` → `0.1.5-alpha.1`.**
-
-*Um cartão de versão mais um scanner de costuras sem dependências, para que «typecheck está verde» nunca seja confundido com «o plugin ainda funciona».*
-
-> **Repositório oficial.** Este é o único repositório oficial do dsh-plugin-upgrade, mantido pela PerryLink. Repositórios com o mesmo nome em outras contas não são afiliados.
-
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
-[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-plugin-upgrade.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
-[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-upgrade/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-plugin-upgrade/actions)
-[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-plugin-upgrade?label=version)](https://github.com/PerryLink/dsh-plugin-upgrade/releases)
-[![npm version](https://img.shields.io/npm/v/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-upgrade)](https://www.npmjs.com/package/dsh-plugin-upgrade)
-
-[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
-
-</div>
-
----
-
-## Compatibilidade
-
-| Superfície | Status |
-|---|---|
-| Harness | DeepSeek Harness `0.1.5-rc.1` (checkout `2efea31131`, tag `dsh-v0.1.5-rc.1` = `183f08e9c6dd`). Faixa de peers `@deepseek-ai/dsh-skill >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0`, `@deepseek-ai/cordis ^4.0.2`, `@deepseek-ai/schemastery ^3.18.2`. |
-| Node | `^22.19.0 \|\| >=24.0.0` |
-| Plataformas | Onde o Node rodar; o scanner só lê o sistema de arquivos e é neutro de plataforma |
-| Modelo | Modelos somente texto são totalmente suportados; a skill é um corpo Markdown, sem exigência de ferramentas ou visão |
-| Escopo | **Um único corredor**: `0.1.3-alpha.1` → `0.1.5-alpha.1`. Não é um framework de migração geral. |
-
-## O que você recebe
-
-Duas metades e um único catálogo de costuras:
-
-- **Uma skill de agente incluída (`plugin-upgrade-015`)** — um cartão de versão e um ciclo de corrigir-e-verificar. O modelo só a carrega quando a tarefa realmente precisa; o pacote não contribui com nenhum parágrafo do prompt de sistema nem registra ferramentas.
-- **Uma CLI sem dependências (`dsh-plugin-upgrade-scan`)** — reporta fatos `arquivo:linha` para dez costuras medidas em 40 repositórios reais de plugins durante a onda de adaptação de 2026-09-09. Sai com `1` a qualquer achado de severidade erro, então entra direto no CI.
-
-O objetivo é o modo de falha que o cartão existe para eliminar: **um portão local verde não é prova de adaptação.** Duas classes de quebra sobrevivem a `typecheck` + `test`:
-
-1. a linha de tipos publicada esconde a costura e o repositório compila contra tipos obsoletos (costura `M1`);
-2. os testes são mockados na forma antiga, então passam enquanto o host rejeita a nova.
-
-Quatro das dez costuras — `S3`, `S8`, `S9`, `M1` — ainda não eram cobertas por nenhum PR comunitário de upgrade quando este pacote foi escrito; as outras seis foram cruzadas com a evidência da onda.
-
-## Início rápido
-
-```sh
-# 1. instale o bundle no seu perfil
-dsh plugin --profile web add dsh-plugin-upgrade
-
-# 2. confirme que a linha montou
-dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-upgrade'
-
-# 3. escaneie o plugin que você está atualizando
-npx dsh-plugin-upgrade-scan --repo ../my-plugin
-```
-
-Depois peça ao agente para usar a skill `plugin-upgrade-015`, ou conduza o ciclo você mesmo com o cartão em
-`skills/plugin-upgrade-015/references/v0.1.3-alpha.1-to-v0.1.5-alpha.1.md`.
-
-## Instalação e desinstalação
-
-```sh
-dsh plugin --profile web add dsh-plugin-upgrade            # do npm
-dsh plugin --profile web add "github:PerryLink/dsh-plugin-upgrade#main"   # do código-fonte
-dsh plugin --profile web remove dsh-plugin-upgrade         # desinstalar (reversível)
-```
-
-Instalar o bundle apenas registra uma skill; remover a linha a remove. A CLI é um alvo `npx` normal e não precisa de perfil algum.
-
-## Configuração
-
-Toda chave é opcional e vive no patch do perfil:
-
-| Chave | Padrão | Significado |
-|---|---|---|
-| `enabled` | `true` | Registra a skill incluída. `false` mantém a dependência montada mas silenciosa. |
-| `skillName` | `plugin-upgrade-015` | Diretório sob `skillsRoot` a registrar, e o nome exibido no catálogo. |
-| `skillsRoot` | o `./skills` do próprio pacote | Onde fica `<skillName>/SKILL.md`. Aponte para o seu próprio cartão para reutilizar a infraestrutura. |
-| `userInvocable` | `true` | Se uma pessoa pode invocar a skill pelo nome além do modelo. |
-
-```yaml
-- insert:
-    - id: dsh-plugin-upgrade
-      name: dsh-plugin-upgrade
-      config:
-        skillName: plugin-upgrade-015
-```
-
-A montagem falha alto: um `SKILL.md` ausente, um corpo vazio ou um frontmatter sem `name` abortam a montagem em vez de registrar uma skill vazia.
-
-## Superfícies
-
-**Skill** — `plugin-upgrade-015` (invocável pelo modelo e pela pessoa por padrão). Corpo: o ciclo de 6 passos. Referências: o cartão de versão. Scripts: o detector, incluído dentro do diretório da skill para que caminhos relativos resolvam.
-
-**CLI** — `dsh-plugin-upgrade-scan`:
-
-```sh
-dsh-plugin-upgrade-scan [--repo <path>] [--json <out.json>] [--seams S3,S8,M1] [--quiet]
-```
-
-| Flag | Significado |
-|---|---|
-| `--repo <path>` | Repositório a escanear (padrão: cwd). |
-| `--json <out.json>` | Também grava o relatório legível por máquina (`repo`, `scannedAt`, `files`, `hits[]`, `bySeam`). |
-| `--seams S3,S8,M1` | Restringe a costuras específicas. |
-| `--quiet` | Silencia a saída humana (combine com `--json`). |
-
-Códigos de saída: `0` nenhum achado de severidade erro · `1` pelo menos um · `2` uso ou falha de varredura. Uma varredura limpa é necessária mas não suficiente — o critério de saída do cartão é um smoke real em um `DSH_HOME` temporário.
-
-## As dez costuras
-
-| Id | Severidade | O que mudou na linha `0.1.5-alpha.1` |
-|---|---|---|
-| `S1` | warn | O formato de sessão é V3; o arquivo de log carrega geração (`session.v3.jsonl.zstd`). Caminhos fixos em `session.jsonl.zstd` param de funcionar em silêncio. |
-| `S2` | warn | `EpochHeader.system` desapareceu; o prompt de sistema é `system/message` no nó 0 da superfície. Leitores precisam de um fallback estrutural. |
-| `S3` | error | `assistant/message` exige `stream`; sem ele a sessão importa mas não pode ser retomada (`Session.fromRestore` rejeita campos de settlement inválidos). |
-| `S4` | error | `tool/code-dispatch` virou `tool/ptc-dispatch`. |
-| `S5` | error | `ctx.agent` foi removido; os chamadores recebem o `Agent` explicitamente. |
-| `S6` | error | `Inbox` virou uma interface de tipo — não pode mais ser construída; use `agent.inbox` e a forma oficial do fixture. |
-| `S7` | warn | `SubprocessHandle.pid` foi removido (só `SubprocessTerminalHandle` mantém `pid`). |
-| `S8` | error | `SessionHandle.read()` agora retorna `SessionHandleReadResult` — desembrulhe `.events`. |
-| `S9` | error | A configuração `persona` do `SystemPrompt` virou `personaPrefix` / `personaSuffix`. |
-| `M1` | error | Um alias `paths` do `tsconfig` apontando para um diretório inexistente faz o TypeScript cair em silêncio nos tipos publicados — o portão local fica **falsamente verde**. |
-
-`S7`, `S1`, `S2` e `S10` são deliberadamente informativos: têm correspondências legítimas (o `pid` do Node, leitores de gerações antigas, o próprio portão adaptativo de eventos de um plugin), então o scanner os reporta como pistas para revisão manual e não como falhas.
-
-## O que isto não cobre
-
-- **Outros corredores.** `0.1.1` → `0.1.2` e linhas futuras ficam fora; o cartão é fixado de propósito, porque um cartão que desvia é pior que nenhum.
-- **O caminho de upgrade do DSH para usuários.** Este pacote atualiza o **código-fonte do plugin**, não a instalação do harness de um usuário.
-- **Comportamento de cliente/navegador.** O scanner é estático; uma metade cliente ainda precisa de asserção real no navegador.
-- **Prova.** Uma varredura limpa é uma hipótese. O critério de saída é um smoke real no host (`DSH_HOME` temporário, CLI alvo, `plugin add <tarball>`, `--dump-config`, mais uma ida e volta de resume para quem escreve logs de sessão).
-
-## Limites de segurança
-
-- **Varredura somente leitura.** A CLI nunca escreve dentro do repositório varrido; `--json` grava apenas no caminho informado.
-- **Sem rede nem shell.** O scanner não importa nada além da biblioteca padrão do Node e nunca cria processos.
-- **Sem segredos.** Nada no pacote lê credenciais, tokens de ambiente ou dados de sessão.
-- **Receita de smoke em sandbox.** A checagem real do cartão usa um `DSH_HOME` criado com `mkdtemp`; nunca toca seu `~/.dsh` real.
-
-## Desenvolvimento
-
-```sh
-pnpm install
-pnpm test                          # node --test (Cordis real + SkillRegistry real)
-pnpm run verify:self-contained     # todo import resolve dentro do pacote
-pnpm run verify:artifacts          # o tarball leva a skill, a CLI e o patch
-pnpm run check:readmes             # consistência dos README em cinco idiomas
-pnpm pack
-```
-
-O scanner traz seus próprios `fixtures/bad-repo` e `fixtures/good-repo` sintéticos, mais um negativo ao vivo em um repositório já adaptado pela onda, de modo que uma regressão no catálogo quebra a suíte em vez de chegar a um usuário.
-
-## Tópicos
-
-`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-upgrade`, `migration`, `skill`, `version-card`, `scanner` (espelham as keywords do `package.json`; `dsh-plugin` é o canal de visibilidade do ecossistema).
-
-## Família de plugins DSH da PerryLink
-
-Parte da família de plugins DSH da PerryLink — 40 repositórios cobrindo sessões, memória, permissões, entrega, observabilidade e ferramentas de desenvolvedor. Explore o catálogo em [perrylink-dsh-catalog.perrylink.workers.dev](https://perrylink-dsh-catalog.perrylink.workers.dev) ou no [tópico `dsh-plugin`](https://github.com/topics/dsh-plugin).
-
-## Licença
-
-Apache-2.0 — veja [LICENSE](LICENSE). As dependências de instalação e suas licenças estão em [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md); nada de terceiros é empacotado.