dsh-output-styles

Configuration

All tunables are Schemastery Config fields (changeable from cordis.yml). Invalid values fail the load.

defaultStyle and rules are declared volatile(), so on a host that composes the settings forms seam they are live, Web-editable fields: edit them under Plugins → dsh-output-styles in the Web UI and the running plugin adopts the new value without a remount. Every other field stays composition-only and needs a reload. A committed value is validated before it is applied — an invalid one is rejected and the running values are left unchanged.

Key	Default	Web-editable	Meaning
stylesDir	[]	no	Style-library directories, resolved against cwd; later entries override earlier ones. [] = the bundled styles/ only
maxStyleChars	4000	no	Style-body budget (≥ 1); longer bodies are truncated with a marker
defaultStyle	''	yes	Style for sessions that never selected one; '' = no style. A name that is not in the live library is refused rather than injected
compatJson	true	no	Load Claude Code outputStyles JSON entries (single objects or arrays)
sectionOrder	90	no	Order of the injected section (0 = persona, 100–199 = tool guidance)
truncationMarker	"\n\n[style truncated]"	no	Marker appended at the truncation point
includeBuiltins	true	no	Include the package's bundled styles/ as the lowest-priority layer
watchStyles	true	no	Reload the library when a style file changes on disk
rules	[]	yes	Per-session/per-tool render rules: [{ match: { tool?, contentType?, session? }, style, priority? }]
enableExport	true	no	Register the /transcript command (Markdown/HTML session export, renderer-aware; --save writes with approval)
respectCoreOutputStyles	true	no	When a core outputStyles service is detected, skip this plugin's prompt injection (keep hot-switch / rules / export)

Migrating from 0.1.6 or earlier. Those versions kept two plugin-owned settings sections, output-style (style) and output-style-rules (rules). The 0.1.7 host deleted the API they were built on, so both sections are gone. Move any value you had there into the corresponding Config field — output-style.style → defaultStyle, output-style-rules.rules → rules — in your profile patch (cordis.yml), or set it on the Plugins page. Per-session choices made with /style are unaffected: they live in the output_style storage domain.