DSH familySearch GitHub

Setup

Set up a plugin

Install it, load its bundle patch, set its  knob, and confirm it activated.
Plugin
126
Two releases
Bundle patch
111
Ships with the package
Configured
84
Documents its knobs

Install

Install the plugin you want; its dependencies come with it.

Install one plugin sh
pnpm add @playform/hook-dsh-normalize-dash

Load

List the package in your profile's bundles, then restart the app. A dependency alone is not activation.

pnpm addprofile bundlesand a restartconfigurationevery knobledgerone line
The path a reader takes: install, load, configure, confirm.
~/.dsh/profiles/<profile>/package.json json
{
	"dsh": {
		"profile": {
			"bundles": [
				"@deepseek-ai/dsh-base",
				"@playform/hook-dsh-normalize-dash"
			]
		}
	}
}
What the package declares for the host
FieldValue
name@playform/hook-dsh-normalize-dash
version0.2.1
main./Target/Library.js
dsh.bundle.patch./cordis.patch.yml

Axis

The eight axes a reader actually turns, across the family. The exact field and default live on each package's page; this is the shape of the choice.

  • enabled 01 on: the listener stops returning the payload untouched
  • threshold 02 a smaller number: the hook acts sooner and on more results
  • replacement 03 another character or string: the normalizer writes what you name
The eight configuration axes, what each ships as, and what turning it does
RowShips asTurn it
enabledoff in most workspace packageson: the listener stops returning the payload untouched
logonoff: the ledger line is not written, the behavior is unchanged
logFilea path under the profilea path of your own, or empty to keep the ledger in memory
domainthe package's own nameanother domain: a second instance writes its own records
targetsthe tools the README listsa shorter list: the hook stops touching the tools you leave out
exemptthe tools that must pass untoucheda longer list: a tool you add here never reaches the hook's body
replacementthe one the README documentsanother character or string: the normalizer writes what you name
thresholdthe size the README documentsa smaller number: the hook acts sooner and on more results

Configure

Every knob hook-dsh-normalize-dash document, with its default.

Configuration of hook-dsh-normalize-dash
FieldTypeDefaultMeaning
logbooleantruewrite the durable ledger file (volatile)
logFilestring~/.dsh/playform/hook-dsh-normalize-dash.logthe normalize-dash ledger (volatile)
replacementstring-the transform's only knob - hot-editable, the next stream picks it up with no remount (volatile)
normalizeReasoningbooleantruenormalize reasoning deltas and the assembled reasoning block too
normalizeToolArgumentsbooleanfalserewrite the tool-call argumentsDelta and the assembled ToolCallBlock.arguments when on - execution-critical raw JSON, the user's accepted risk
scopesobjectsee belowgates every arm independently; the whole object is volatile
scopes.conversationbooleantruetext-delta text + the assembled text/reasoning blocks
scopes.reasoningbooleantruethe reasoning-delta sub-gate (ANDed with normalizeReasoning)
scopes.toolInputbooleanfalsethe tool-call arguments arm (OR-ed with normalizeToolArguments)
scopes.toolResultsbooleanfalsethe tools/post-execute arm
scopes.filesbooleantrueinert in a stream flavor (present so one patch override drives the whole family)
scopes.batchbooleanfalsethe agent/pre-step arm
toolResultsExemptstring[]read, edit, raw-write, normalize-file, ccr_retrieve, subagent, ask_user_questiona tool result whose exec name is listed passes the tool-results arm by identity (volatile)

Open the plugin to read the rest.

Confirm

The plugin writes one line to its ledger when it activates.

Ledger read-only

cat ~/.dsh/playform/hook-dsh-normalize-dash.log

hook-dsh-normalize-dash: activated (replacement=-, reasoning=on, toolArgs=off)