dsh-output-styles 0.2.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 dsh-output-styles contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.es.md

@@ -0,0 +1,197 @@
+<div align="center">
+
+# 🎨 dsh-output-styles
+
+**El `outputStyles` de Claude Code para DeepSeek Harness** — cambia el estilo de salida del modelo en tiempo de ejecución, por sesión y de forma duradera.
+
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
+
+🌐 [English](README.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md)
+
+</div>
+
+---
+
+`/style concise` — y todas las respuestas siguientes serán concisas. `/style step-by-step` — y el modelo narra pasos numerados. `/style off` — de vuelta al valor por defecto del proyecto. Un comando por sesión, persistente entre reinicios y con cero cambios en el bucle del agente.
+
+## ✨ Características
+
+| | |
+|---|---|
+| 🗂️ **Biblioteca de estilos** | Un archivo Markdown por estilo (`styles/*.md`); frontmatter para los metadatos, cuerpo = la directiva del modelo. `name` toma por defecto el nombre del archivo y puede contener espacios (`Diagrams first`). |
+| ⌨️ **Comando `/style`** | Sin argumentos lista los estilos (con descripciones) + la selección actual; `/style <name>` cambia; `/style off` restaura el valor por defecto del proyecto. Todo el resto tras `/style` es el nombre del estilo. |
+| 💾 **Persistencia por sesión** | La elección vive en el dominio de almacenamiento `output_style`, con clave sessionId: dos sesiones nunca interfieren y la elección sobrevive a los reinicios. |
+| 🧩 **Inyección en el system prompt** | Una contribución `systemPrompt.section()` (orden 90) inyecta el cuerpo del estilo de la sesión actual en cada ensamblado; los cuerpos se truncan según un presupuesto configurable. |
+| 🎭 **`keep-coding-instructions` de Claude Code** | Los estilos con `keep-coding-instructions: false` (el valor por defecto, como Claude Code) reemplazan todo el system prompt — para estilos que dejan atrás la ingeniería de software. |
+| 📌 **Estilos forzados** | `force: true` aplica un estilo incondicionalmente, anulando cualquier selección de sesión; dos estilos forzados hacen fallar la carga. |
+| 🔁 **Compatibilidad con Claude Code** | Carga colecciones JSON `outputStyles` (`{ name, description, prompt }`), entradas individuales o matrices estilo `settings.json`; las entradas no analizables se omiten con un aviso. |
+| 📚 **Directorios en capas** | `stylesDir` es una lista; los directorios posteriores anulan los anteriores (el `styles/` incluido es la capa más baja; desactívalo con `includeBuiltins: false`). |
+| 🔄 **Recarga en caliente** | Los cambios en los archivos de estilo se detectan sin reiniciar (`watchStyles: false` para desactivarlo). |
+| ⚙️ **Valor por defecto del proyecto sobre ajustes** | Las sesiones que nunca eligieron uno recurren a `output-style.style` de los ajustes de DSH y, a continuación, a `defaultStyle`. |
+| 🖱️ **Selector web** | Una entrada `dsh.client` (`dsh-output-styles/client`) decora el comando `/style` del host con un selector emergente basado en proyecciones. |
+| 📊 **Proyección de sesión** | Una proyección `style` (`{ options, currentValue }`) para la Web UI, plegada a partir de los comandos asentados en el log de sesión. |
+| 🧯 **Fallo ruidoso, omisión limpia** | La configuración incorrecta lanza al cargar; un archivo de estilo defectuoso se omite con un aviso y nunca rompe el perfil. |
+| 🌐 **Documentación en cinco idiomas** | EN · 中文 · 日本語 · 한국어 · Español. |
+
+## 🚀 Inicio rápido
+
+```sh
+# 1. Instalar — el paquete es una capa de bundle, así que un comando compone
+#    storage + storage-json + storage-domain + la fila del plugin:
+dsh plugin --profile <name> add dsh-output-styles
+
+# 2. Arrancar y cambiar
+dsh --profile <name>
+/style               # → output style off y luego una línea por estilo
+/style concise       # → switched to concise
+/style Diagrams first  # → los nombres con espacios también funcionan
+/style off           # → de vuelta al valor por defecto del proyecto
+```
+
+La capa es idempotente sobre los perfiles web (la inserción por id reemplaza las filas con el mismo id), que componen `storage` de fábrica. Para el selector web, añade la fila del cliente al perfil:
+
+```yaml
+- id: output-styles-client
+  name: 'dsh-output-styles/client'
+```
+
+## 🎬 Demo
+
+```
+You > /style
+      output style off
+      concise — Terse, direct answers — minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
+      explanatory — Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, …)
+      formal — Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, …)
+      step-by-step — Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, …)
+
+You > /style concise
+      switched to concise
+
+You > Preséntate en una sola frase.
+AI  > Soy un agente de codificación de IA que se ejecuta sobre la plataforma de plugins DeepSeek Harness y se basa en el modelo deepseek-v4-pro.
+```
+
+## 🧠 Cómo funciona
+
+```mermaid
+flowchart LR
+    U[Escribes /style concise] --> C[registro de comandos]
+    C -->|command/run registrado| L[(log de sesión)]
+    C -->|put {style, source}| D[(dominio output_style)]
+    D --> R[OutputStyleRuntime]
+    R -->|cuerpo en cada ensamblado| S[sección systemPrompt orden 90]
+    S --> M[Petición al modelo]
+    M -->|system prompt completo| H[request/header registrado]
+```
+
+Todo lo que ve el modelo es reconstruible desde el log de sesión — sin nuevos tipos de eventos de sesión ni cambios en el bucle del agente. El nombre del estilo viene de `command/run`, el texto inyectado exacto de `request/header`, y el marcador de procedencia `{ kind: 'plugin', plugin: 'dsh-output-styles' }` viaja en el registro del dominio. Los estilos se aplican solo a la conversación principal; las sesiones de los subagentes mantienen sus propios prompts (igual que Claude Code).
+
+## ⚙️ Configuración
+
+Todo ajuste es un campo `Config` de Schemastery validado (los valores inválidos fallan la carga):
+
+| Campo | Defecto | Significado |
+|---|---|---|
+| `stylesDir` | `[]` | Directorios de la biblioteca de estilos, resueltos contra cwd; las entradas posteriores anulan las anteriores. `[]` = solo el `styles/` incluido. Una cadena simple es una lista de un solo directorio. |
+| `maxStyleChars` | `4000` | Presupuesto del cuerpo del estilo (puntos de código, ≥ 1); los cuerpos más largos se truncan con un marcador. |
+| `defaultStyle` | `''` | Estilo para las sesiones que nunca eligieron uno (y no existe un valor por defecto en ajustes); `''` = sin estilo. |
+| `compatJson` | `true` | Carga las entradas JSON `outputStyles` de Claude Code (objetos individuales o matrices). |
+| `sectionOrder` | `90` | Orden de la sección inyectada (0 = persona, 100–199 = guía de herramientas). |
+| `truncationMarker` | `"\n\n[style truncated]"` | Marcador añadido en el punto de truncado. |
+| `includeBuiltins` | `true` | Incluye el `styles/` incluido en el paquete como la capa de menor prioridad. |
+| `watchStyles` | `true` | Recarga la biblioteca cuando un archivo de estilo cambia en disco. |
+
+## 📚 Biblioteca de estilos
+
+<details>
+<summary><code>styles/concise.md</code></summary>
+
+```markdown
+---
+name: concise
+description: Terse, direct answers — minimal prose, no preamble.
+whenToUse: Daily coding work, tool-heavy sessions, or when prompt length matters.
+keep-coding-instructions: true
+---
+
+You are in the concise output style for this conversation.
+- Lead with the direct answer; skip preamble, restatements, and filler.
+- 回答语言跟随用户语言：中文提问用中文回答，英文提问用英文回答。
+```
+
+</details>
+
+Campos del frontmatter:
+
+| Campo | Defecto | Significado |
+|---|---|---|
+| `name` | nombre del archivo | Objetivo del cambio; letras, dígitos, espacios y guiones (sin espacio inicial/final; `off` está reservado). |
+| `description` | — (obligatorio) | Una frase mostrada en los listados y en el selector. |
+| `whenToUse` | — | Guía opcional añadida a los listados. |
+| `keep-coding-instructions` | `false` | Conserva el prompt del harness (identidad, persona, guía de herramientas) cuando es `true`; lo reemplaza por completo cuando es `false` (semántica de Claude Code). |
+| `force` | `false` | Se aplica incondicionalmente, anulando cualquier selección de sesión; como máximo un estilo puede activarlo. |
+
+<details>
+<summary>JSON de Claude Code <code>outputStyles</code> (<code>compatJson: true</code>)</summary>
+
+```json
+{ "name": "explain", "description": "Explain like a teacher.", "prompt": "Teach in small steps." }
+```
+
+Las matrices heredadas de `settings.json` (`[{ … }, { … }]`) se cargan tal cual; las entradas incorrectas se omiten con un aviso.
+
+</details>
+
+## ⌨️ Referencia de comandos
+
+| Entrada | Resultado |
+|---|---|
+| `/style` | Lista la selección actual + una línea por estilo (nombre — descripción) |
+| `/style concise` | Cambia (escritura duradera), `switched to concise` |
+| `/style Diagrams first` | Los nombres de varias palabras son todo el resto |
+| `/style off` | Restaura el valor por defecto del proyecto (valor por defecto de ajustes, luego `defaultStyle`) |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+
+## 🖱️ Selector web
+
+La entrada `dsh.client` decora la invocación sin argumentos del comando `/style` del host con un selector emergente: una fila «off» más una fila por estilo de la biblioteca (`description · whenToUse`), con la fila activa marcada. Al elegir se envía `/style <name>` a través del Remote de comandos, de modo que cada cambio conserva el ciclo de vida duradero de comandos del host y la proyección `style` sigue siendo el único dato mostrado.
+
+## 🔍 Verificación de conflictos
+
+Se contrastó con el ecosistema DSH antes del desarrollo (instantánea 2026-08): ningún repositorio `style`/`output-style` bajo [topic:dsh-plugin](https://github.com/topics/dsh-plugin), ninguna categoría de output-style en las cuatro [listas awesome](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) principales, y ninguna entrada en el [catálogo dsh-hub](https://github.com/omdsh-dev/dsh-hub-workshop). Los vecinos más cercanos — [dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md) (persona) y [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace) (estilos de salida diferidos explícitamente a v0.2+) — son adyacentes, no conflictivos.
+
+## 🆚 Diferencias con Claude Code
+
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| Archivos de estilo | `.claude/output-styles` en los niveles usuario/proyecto/gestionado | Directorios `stylesDir` + `styles/` incluido, gana el directorio posterior |
+| Estilos personalizados | Markdown, frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | Los mismos campos (`force` = `force-for-plugin`) + `whenToUse` |
+| JSON heredado | Matriz `outputStyles` en `settings.json` | Se carga tal cual (`compatJson: true`) |
+| Entrada en vigor | Tras `/clear` o una sesión nueva | Inmediatamente — el system prompt se reensambla en cada petición |
+| Subagentes | Los estilos no se aplican | Igual — las sesiones de los subagentes mantienen sus propios prompts |
+| Cambio | Menú `/config` o ajuste `outputStyle` (el comando `/output-style` se eliminó en v2.1.91) | Comando `/style` + selector web + ajustes `output-style.style` |
+
+## 🧪 Desarrollo
+
+```sh
+pnpm install
+pnpm run typecheck   # ambos proyectos tsc
+pnpm test            # vitest — 87 pruebas
+pnpm run build       # artefactos lib/ (bundles de host + cliente)
+pnpm pack            # tarball para dsh plugin add
+```
+
+La estructura sigue [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template): `src/index.ts` (metadatos del plugin), `src/config.ts` (esquema), `src/runtime.ts` (servicio de runtime + activación), `src/invariant.ts` (invariantes), `src/client/` (selector web), `styles/` (estilos integrados).
+
+## 📄 Licencia
+
+[Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors
+
+---
+
+<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>

package/README.ja.md

@@ -0,0 +1,197 @@
+<div align="center">
+
+# 🎨 dsh-output-styles
+
+**DeepSeek Harness 向け Claude Code `outputStyles`** —— モデルの出力スタイルを実行時に、セッション単位で、永続的に切り替えます。
+
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
+
+🌐 [English](README.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md)
+
+</div>
+
+---
+
+`/style concise` —— これ以降の返信はすべて簡潔になります。`/style step-by-step` —— モデルが番号付きの手順で説明します。`/style off` —— プロジェクトのデフォルトに戻ります。セッションごとに 1 コマンド、再起動をまたいで保持され、agent loop には一切変更を加えません。
+
+## ✨ 機能
+
+| | |
+|---|---|
+| 🗂️ **スタイルライブラリ** | スタイルごとに 1 つの Markdown ファイル（`styles/*.md`）。frontmatter にメタデータ、本文がモデルへの指示です。`name` は既定でファイル名になり、空白を含めます（`Diagrams first`）。 |
+| ⌨️ **`/style` コマンド** | 引数なしでスタイル一覧（説明付き）と現在の選択を表示。`/style <name>` で切り替え、`/style off` でプロジェクトのデフォルトを復元します。`/style` より後の残り全体がスタイル名です。 |
+| 💾 **セッション単位の永続化** | 選択は `output_style` ストレージドメインに sessionId をキーとして保持され、2 つのセッションが干渉することはなく、選択は再起動後も残ります。 |
+| 🧩 **システムプロンプト注入** | `systemPrompt.section()` の貢献（order 90）が、毎回の組み立てで現在のセッションのスタイル本文を注入します。本文は設定可能なバジェットで切り詰められます。 |
+| 🎭 **Claude Code `keep-coding-instructions`** | `keep-coding-instructions: false`（Claude Code と同じ既定）のスタイルはシステムプロンプト全体を置き換えます——ソフトウェアエンジニアリングから離れるスタイル向けです。 |
+| 📌 **強制スタイル** | `force: true` はセッションの選択を無視して無条件にスタイルを適用します。強制スタイルが 2 つあると読み込みに失敗します。 |
+| 🔁 **Claude Code 互換性** | `outputStyles` JSON コレクション（`{ name, description, prompt }`）を読み込みます。単一エントリまたは `settings.json` 形式の配列に対応し、解析不能なエントリは警告付きでスキップします。 |
+| 📚 **ディレクトリの階層化** | `stylesDir` はリストで、後方のディレクトリが前方のものを上書きします（同梱の `styles/` が最下層で、`includeBuiltins: false` で無効化）。 |
+| 🔄 **ホットリロード** | スタイルファイルの変更は再起動なしで反映されます（`watchStyles: false` で無効化）。 |
+| ⚙️ **settings とプロジェクトデフォルト** | 一度も選択していないセッションは、DSH settings の `output-style.style`、次いで `defaultStyle` にフォールバックします。 |
+| 🖱️ **Web ピッカー** | `dsh.client` エントリ（`dsh-output-styles/client`）が、ホストの `/style` コマンドを投影ベースのポップアップピッカーで装飾します。 |
+| 📊 **セッション投影** | Web UI 向けの `style` 投影（`{ options, currentValue }`）。セッションログ内で確定したコマンドから折りたたまれます。 |
+| 🧯 **失敗は明示、スキップはクリーンに** | 設定ミスは読み込み時に例外を投げます。不正なスタイルファイルは警告付きでスキップされ、プロファイルを壊すことはありません。 |
+| 🌐 **5 言語のドキュメント** | EN · 中文 · 日本語 · 한국어 · Español。 |
+
+## 🚀 クイックスタート
+
+```sh
+# 1. インストール——このパッケージは bundle レイヤーなので、1 コマンドで
+#    storage + storage-json + storage-domain + プラグイン行が構成されます：
+dsh plugin --profile <name> add dsh-output-styles
+
+# 2. 起動して切り替え
+dsh --profile <name>
+/style               # → output style off、その後にスタイルごとに 1 行
+/style concise       # → switched to concise
+/style Diagrams first  # → 空白を含む名前も使えます
+/style off           # → プロジェクトのデフォルトに戻る
+```
+
+このレイヤーは web プロファイルに対して冪等です（id 単位の挿入が同 id の行を置き換えます）。web プロファイルには `storage` があらかじめ含まれています。Web ピッカーを使うには、プロファイルにクライアント行を追加します：
+
+```yaml
+- id: output-styles-client
+  name: 'dsh-output-styles/client'
+```
+
+## 🎬 デモ
+
+```
+You > /style
+      output style off
+      concise — Terse, direct answers — minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
+      explanatory — Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, …)
+      formal — Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, …)
+      step-by-step — Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, …)
+
+You > /style concise
+      switched to concise
+
+You > 一文だけで自己紹介してください。
+AI  > 私は DeepSeek Harness プラグインプラットフォーム上で動作する、deepseek-v4-pro モデルベースの AI コーディングエージェントです。
+```
+
+## 🧠 仕組み
+
+```mermaid
+flowchart LR
+    U[/style concise と入力] --> C[コマンドレジストリ]
+    C -->|command/run を記録| L[(セッションログ)]
+    C -->|put {style, source}| D[(output_style ドメイン)]
+    D --> R[OutputStyleRuntime]
+    R -->|毎回の組み立てで本文を注入| S[systemPrompt セクション order 90]
+    S --> M[モデルリクエスト]
+    M -->|完全なシステムプロンプト| H[request/header を記録]
+```
+
+モデルが見るものはすべてセッションログから再構築できます——新しいセッションイベント型も agent-loop の変更も不要です。スタイル名は `command/run` から、注入された正確なテキストは `request/header` から得られ、出所マーカー `{ kind: 'plugin', plugin: 'dsh-output-styles' }` はドメインレコードに残ります。スタイルはメイン会話のみに適用され、サブエージェントのセッションは独自のプロンプトを保持します（Claude Code と一致）。
+
+## ⚙️ 設定
+
+すべての調整項目は検証付きの Schemastery `Config` フィールドです（不正な値は読み込みに失敗します）：
+
+| フィールド | 既定 | 意味 |
+|---|---|---|
+| `stylesDir` | `[]` | スタイルライブラリのディレクトリ。cwd を基準に解決され、後方のエントリが前方のものを上書きします。`[]` = 同梱の `styles/` のみ。裸の文字列は単一ディレクトリのリストとみなされます。 |
+| `maxStyleChars` | `4000` | スタイル本文のバジェット（コードポイント、≥ 1）。長い本文はマーカー付きで切り詰められます。 |
+| `defaultStyle` | `''` | 一度も選択していないセッション（かつ settings の既定もない）向けのスタイル。`''` = スタイルなし。 |
+| `compatJson` | `true` | Claude Code `outputStyles` の JSON エントリ（単一オブジェクトまたは配列）を読み込みます。 |
+| `sectionOrder` | `90` | 注入セクションの順序（0 = persona、100–199 = ツールガイダンス）。 |
+| `truncationMarker` | `"\n\n[style truncated]"` | 切り詰め位置に付加されるマーカー。 |
+| `includeBuiltins` | `true` | パッケージ同梱の `styles/` を最優先度の低いレイヤーとして含めます。 |
+| `watchStyles` | `true` | スタイルファイルがディスク上で変更されたときにライブラリを再読み込みします。 |
+
+## 📚 スタイルライブラリ
+
+<details>
+<summary><code>styles/concise.md</code></summary>
+
+```markdown
+---
+name: concise
+description: Terse, direct answers — minimal prose, no preamble.
+whenToUse: Daily coding work, tool-heavy sessions, or when prompt length matters.
+keep-coding-instructions: true
+---
+
+You are in the concise output style for this conversation.
+- Lead with the direct answer; skip preamble, restatements, and filler.
+- 回答语言跟随用户语言：中文提问用中文回答，英文提问用英文回答。
+```
+
+</details>
+
+frontmatter フィールド：
+
+| フィールド | 既定 | 意味 |
+|---|---|---|
+| `name` | ファイル名 | 切り替え対象。英字、数字、空白、ハイフン（先頭・末尾の空白は不可。`off` は予約済み）。 |
+| `description` | —（必須） | 一覧とピッカーに表示される 1 文。 |
+| `whenToUse` | — | 一覧に追記される任意の利用ガイダンス。 |
+| `keep-coding-instructions` | `false` | `true` のときハーネスのプロンプト（アイデンティティ、persona、ツールガイダンス）を保持し、`false` のとき完全に置き換えます（Claude Code のセマンティクス）。 |
+| `force` | `false` | セッションの選択を無視して無条件に適用します。設定できるのは最大 1 つのスタイルです。 |
+
+<details>
+<summary>Claude Code <code>outputStyles</code> JSON（<code>compatJson: true</code>）</summary>
+
+```json
+{ "name": "explain", "description": "Explain like a teacher.", "prompt": "Teach in small steps." }
+```
+
+レガシーの `settings.json` 配列（`[{ … }, { … }]`）はそのまま読み込まれ、不正なエントリは警告付きでスキップされます。
+
+</details>
+
+## ⌨️ コマンドリファレンス
+
+| 入力 | 結果 |
+|---|---|
+| `/style` | 現在の選択 + スタイルごとに 1 行（name — description）を一覧表示 |
+| `/style concise` | 切り替え（永続書き込み）、`switched to concise` |
+| `/style Diagrams first` | 複数語の名前は残り全体が対象 |
+| `/style off` | プロジェクトのデフォルトを復元（settings の既定、次いで `defaultStyle`） |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+
+## 🖱️ Web ピッカー
+
+`dsh.client` エントリは、ホストの `/style` コマンドの引数なし呼び出しをポップアップピッカーで装飾します：「off」行 + ライブラリのスタイルごとに 1 行（`description · whenToUse`）で、アクティブな行がマークされます。選択するとコマンド Remote を通じて `/style <name>` が送信されるため、どの切り替えもホストの永続的なコマンドライフサイクルを経由し、`style` 投影が唯一の表示事実であり続けます。
+
+## 🔍 競合チェック
+
+開発前に DSH エコシステムを調査しました（2026-08 スナップショット）：[topic:dsh-plugin](https://github.com/topics/dsh-plugin) 配下に `style`/`output-style` のリポジトリはなく、4 つの主要な [awesome リスト](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) に output-style カテゴリはなく、[dsh-hub カタログ](https://github.com/omdsh-dev/dsh-hub-workshop) にもエントリはありません。最も近い隣接プロジェクト——[dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md)（persona）と [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace)（出力スタイルは明示的に v0.2+ へ先送り）——は隣接していて、競合はしません。
+
+## 🆚 Claude Code との違い
+
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| スタイルファイル | ユーザー/プロジェクト/マネージド階層の `.claude/output-styles` | `stylesDir` ディレクトリ + 同梱の `styles/`。後方のディレクトリが優先 |
+| カスタムスタイル | Markdown、frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | 同じフィールド（`force` = `force-for-plugin`）+ `whenToUse` |
+| レガシー JSON | `settings.json` 内の `outputStyles` 配列 | そのまま読み込み（`compatJson: true`） |
+| 反映タイミング | `/clear` 後または新しいセッション | 即時——システムプロンプトはリクエストごとに再構築 |
+| サブエージェント | スタイルは適用されない | 同じ——サブエージェントのセッションは独自のプロンプトを保持 |
+| 切り替え | `/config` メニューまたは `outputStyle` 設定（`/output-style` コマンドは v2.1.91 で削除） | `/style` コマンド + Web ピッカー + settings `output-style.style` |
+
+## 🧪 開発
+
+```sh
+pnpm install
+pnpm run typecheck   # 両方の tsc プロジェクト
+pnpm test            # vitest — 87 テスト
+pnpm run build       # lib/ 成果物（ホスト + クライアント bundle）
+pnpm pack            # dsh plugin add 用の tarball
+```
+
+構成は [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template) に従います：`src/index.ts`（プラグインメタデータ）、`src/config.ts`（スキーマ）、`src/runtime.ts`（ランタイムサービス + アクティベーション）、`src/invariant.ts`（不変条件）、`src/client/`（Web ピッカー）、`styles/`（組み込みスタイル）。
+
+## 📄 ライセンス
+
+[Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors
+
+---
+
+<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>