tonedial 0.1.6 → 0.1.7

package/README.zh.md

@@ -2,7 +2,7 @@
 
 **给编程代理一个角色。**
 
-选择角色，调整十二个语气轴，保存一套能在不同项目中复用的语气。
+ToneDial 是本地 CLI，用于调整编程代理的语气并在不同项目中复用。
 
 **7 个角色 · 12 个语气轴 · 5 种 CLI 语言 · 零运行时依赖**
 
@@ -19,9 +19,36 @@
 
 **[查看全部 7 个角色 →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.zh.md)**
 
-## 试试这样用？
+## 同一模型，更精简的计划
 
-完成[设置](#开始试用)后，选择一组配置。
+在 `gpt-5.6-sol` / `high` 下，一个全新会话使用 Codex 默认设置，另一个使用下方完整的 `vibe-coder` 配置。
+`verbosity=1` 只是该配置的一部分，并非唯一差异。
+
+**指令**
+
+> I want to make ToneDial easier for first-time users. The README should get them from installation through `tonedial init` to their first preview with `tonedial test codex --preset <slug>`, and the CLI should make that next step obvious after `init`. Give me a prioritized three-step improvement plan for the README and first-run CLI flow.
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/zh/verbosity-comparison.svg" alt="GPT-5.6 Sol high 使用 Codex 默认设置和完整 vibe-coder 配置回答同一条 ToneDial 改进计划指令；配置后的英文回复从 148 个词缩短到 82 个词" width="760">
+
+<sub>同一指令 · 每个新会话的首次完整回复 · 英文回复 148 个词 → 82 个词。这是一次示例性对比，并非只隔离单个轴的基准测试。回复用于展示语气差异；产品行为和命令请以下方指南为准。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/verbosity-comparison.json">输入与生成记录</a>.</sub>
+
+## 开始试用
+
+需要 **Node 24 或更高版本**和 npm。
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang zh
+tonedial set
+```
+
+设置时会先展示文件变更并请求批准。无需连接代理即可先打开面板试用。
+
+[连接代理](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [使用临时设置试用](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## 复制一种语气
+
+复制完整配置，或把它作为自定义设置的起点。
 每条命令都会保存并应用完整配置；`--auto` 会批准显示的更改。
 
 实际 `tonedial test codex` 回复 · `gpt-6.1-sol` / `high` · 每组配置保留问题的首次回答 · 仅对话，不编辑文件。 [输入与生成记录](https://github.com/awesometic/tonedial/blob/main/docs/media/readme/zh/use-cases.json).
@@ -35,7 +62,7 @@
 话少、直接选定推荐方案，简短汇报做完了什么、还剩什么的编程搭档。
 
 <details>
-<summary>复制这套配置</summary>
+<summary>配置与实际回复</summary>
 
 ```bash
 tonedial create '彻底放手的氛围编程' --slug vibe-coder --auto \
@@ -51,8 +78,6 @@ tonedial create '彻底放手的氛围编程' --slug vibe-coder --auto \
 
 试试这个语气: `tonedial test codex --preset vibe-coder`
 
-</details>
-
 **Codex**
 
 > 老板，我选把 `null` 和 `undefined` 转为空字符串，避免 `trim()` 报错：
@@ -63,13 +88,14 @@ tonedial create '彻底放手的氛围编程' --slug vibe-coder --auto \
 > }
 > ```
 
+</details>
 
 ### 需要安慰的时候
 
 温柔、爱夸人，偶尔说几句安慰的话，像个让人安心的搭档。
 
 <details>
-<summary>复制这套配置</summary>
+<summary>配置与实际回复</summary>
 
 ```bash
 tonedial create '需要安慰的时候' --slug steady-companion --auto \
@@ -85,8 +111,6 @@ tonedial create '需要安慰的时候' --slug steady-companion --auto \
 
 试试这个语气: `tonedial test codex --preset steady-companion`
 
-</details>
-
 **Codex**
 
 > 我的选择：搭档，把 `null` 和 `undefined` 当作空字符串，其他输入保留原来的处理方式。
@@ -101,13 +125,14 @@ tonedial create '需要安慰的时候' --slug steady-companion --auto \
 >
 > 你贴出的函数很清楚，指出触发条件很细致，聚焦一个方案很明智，要求直接替换的版本也很周到。辛苦了，我陪你拆问题，慢慢来，放心先喘口气——这个空值小坑已经有块补丁了。
 
+</details>
 
 ### 就喜欢嘴狠的
 
 脏话照说，嘲讽照给，活也照样干利索的狠角色。
 
 <details>
-<summary>复制这套配置</summary>
+<summary>配置与实际回复</summary>
 
 ```bash
 tonedial create '就喜欢嘴狠的' --slug rough-but-reliable --auto \
@@ -123,8 +148,6 @@ tonedial create '就喜欢嘴狠的' --slug rough-but-reliable --auto \
 
 试试这个语气: `tonedial test codex --preset rough-but-reliable`
 
-</details>
-
 **Codex**
 
 > 喂，老子选空值返回空字符串这招，一行就把这他妈的崩溃点收拾利索：
@@ -137,23 +160,11 @@ tonedial create '就喜欢嘴狠的' --slug rough-but-reliable --auto \
 >
 > `null` 或 `undefined` 返回 `""`，`"  Ada  "` 返回 `"Ada"`。
 
+</details>
+
 Codex 开始对话后，输入上面的问题即可。
 模型与推理强度由 Codex 设置，与 ToneDial 配置分开。
 
-## 开始试用
-
-需要 **Node 24 或更高版本**和 npm。
-
-```bash
-npm install --global tonedial
-tonedial init --tools none --global --lang zh
-tonedial set
-```
-
-设置时会先展示文件变更并请求批准。无需连接代理即可先打开面板试用。
-
-[连接代理](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [使用临时设置试用](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
-
 ## 选择你的角色
 
 | 预设 | 你 → 代理 |

package/dist/cli.js

@@ -30,13 +30,14 @@ import { runEject } from "./commands/eject.js";
 import { runInit } from "./commands/init.js";
 import { runUnwire, runWire } from "./commands/wire.js";
 import { runTest } from "./commands/test.js";
+import { runOff, runOn } from "./commands/toggle.js";
 export const JSON_SCHEMA = 3;
 /**
  * Stated here rather than read from `package.json`, because reading a package-relative file at
  * run time is the one thing that breaks all three binary packagers at once. A test asserts this
  * equals the manifest, which is the cheap half of the trade.
  */
-export const VERSION = "0.1.6";
+export const VERSION = "0.1.7";
 const FLAG_NAMES = ["project", "check", "explain", "global", "here", "migrateLegacy", "auto", "dryRun", "fix", "rollback", "quarantineOperation", "fromOperation", "fromPreset", "restorePreset", "preset", "slug", "acceptUsage", "lang", "commands", "tools"];
 /** Command-line spelling for each flag, where it differs from the field name. */
 const FLAG_SPELLING = {
@@ -49,6 +50,8 @@ const FLAG_SPELLING = {
 };
 /** Each command declares its accepted flags and positional limit; null means unlimited. */
 const COMMANDS = {
+    on: { run: runOn, flags: [], max: 0, context: "state" },
+    off: { run: runOff, flags: [], max: 0, context: "state" },
     set: { run: runSet, flags: [], max: null, context: "state" },
     get: { run: runGet, flags: [], max: 1 },
     test: { run: runTest, flags: ["project", "dryRun", "preset", "acceptUsage"], max: 1 },
@@ -81,6 +84,8 @@ export const COMMAND_NAMES = Object.keys(COMMANDS);
 /** Intent groups share one command inventory between compact and full help. */
 const COMMAND_GROUPS = [
     ["tone", [
+            ["on", "on"],
+            ["off", "off"],
             ["set", "set <key>=<value> …"],
             ["get", "get [key]"],
             ["address", "address [self user]"],
@@ -112,6 +117,8 @@ const COMMAND_GROUPS = [
 ];
 const COMMAND_SYNTAX = COMMAND_GROUPS.flatMap(([, rows]) => rows);
 const COMMAND_EXAMPLES = {
+    on: ["tonedial on"],
+    off: ["tonedial off"],
     set: ["tonedial set", "tonedial set warmth=5 critique=4", "tonedial set persona.agent=reviewer"],
     get: ["tonedial get", "tonedial get language", "tonedial get speech_level --json"],
     test: ["tonedial test codex --dry-run", "tonedial test claude --project .", "tonedial test codex --preset my-tone --accept-usage"],
@@ -274,16 +281,12 @@ function columns(env, stream, isTTY) {
     return isTTY ? stream.columns : undefined;
 }
 /**
- * Words a person reaches for when they want to stop, none of which is a command.
- *
- * There is no off switch to give them, so the answer names the acts that do exist and says so.
+ * Words a person reaches for when they want to stop, but which are not command spellings.
  *
  * A deliberate ceiling: the list is guessed, not measured — nobody has reported typing any of
- * them. Replace it with a measured one when a user reports a word that is not here, or drop it
- * if the answer turns out to be the list of seventeen after all. The cost of being wrong is one
- * string; the cost of being right is that `tonedial off` stops dead-ending in that list.
+ * them. Replace it with a measured one when a user reports a word that is not here.
  */
-const STOPPING = ["off", "disable", "stop", "quit", "uninstall", "remove", "delete"];
+const STOPPING = ["disable", "stop", "quit", "uninstall", "remove", "delete"];
 export async function run(argv, env = process.env, cwd = process.cwd(), isTTY = process.stdout.isTTY === true, isErrTTY = process.stderr.isTTY === true) {
     const options = {
         json: { type: "boolean", default: false },
@@ -387,7 +390,7 @@ export async function run(argv, env = process.env, cwd = process.cwd(), isTTY =
         // one: `stop` is two edits from `show` and `delete` three from `reset`, so the match would
         // answer a person trying to leave with the command they were leaving.
         if (STOPPING.includes(name))
-            return fail(asJson, say.errors.noOffSwitch, 2, uiErr);
+            return fail(asJson, say.errors.stoppingHelp, 2, uiErr);
         return fail(asJson, say.errors.notACommand(asJson ? name : humanText(name), COMMAND_NAMES, nearest(name, COMMAND_NAMES)), 2, uiErr);
     }
     const flags = {

package/dist/commands/compile.js

@@ -107,7 +107,7 @@ export async function runCompile(ctx) {
             `  ${ctx.ui.dim(artifactSize(size, ctx.t))}`,
             ...nextStep(check && !current ? "tonedial compile" : "tonedial show", ctx.ui),
         ],
-        json: { path: ctx.paths.tone, agentsPath: ctx.paths.agents, written: !check, ...size },
+        json: { path: ctx.paths.tone, agentsPath: ctx.paths.agents, enabled: config.enabled, written: !check, ...size },
         warnings: [],
     };
 }

package/dist/commands/doctor.js

@@ -11,6 +11,7 @@ import { join, relative } from "node:path";
 import { AGENT_TOOLS, CONTEXT_ARTIFACT_FILENAME, CONTEXT_GUIDE_FILENAME, UPDATE_COMMAND, connectionScopeFlag, onPath, readerPath, resolveAgentPaths, shimScript, installShape, canonicalDestination, shellQuote } from "../core/paths.js";
 import { SKILL_NAME } from "../core/skill.js";
 import { GUIDE_FORMAT_MARKER } from "../core/reader.js";
+import { DELIVERY_OFF_MARKER } from "../core/anchors.js";
 import { inspect as inspectSkill, skillPath } from "../wiring/skill.js";
 import { candidateRcPaths, pathLineState, rcPath, withPathLine } from "../wiring/shell.js";
 import { SEED_VERSION, inspectContextLayout, inspectSeeds, recordedSeedSelection, } from "../core/seeds.js";
@@ -94,7 +95,9 @@ function readerHealth(ctx, config, configRead, seeds, pairRequired) {
         temporary = mkdtempSync(join(tmpdir(), "tonedial-reader-check-"));
         temporary = realpathSync(temporary);
         const guide = `${GUIDE_FORMAT_MARKER}\nToneDial diagnostic guide.\n`;
-        const artifact = "ToneDial diagnostic tone — 한글 🌿.\n";
+        const artifact = config.enabled
+            ? "ToneDial diagnostic tone — 한글 🌿.\n"
+            : `<!-- generated by tonedial · preset: unsaved -->\n<!-- tonedial-style:1 verbosity=3 care=3 -->\n${DELIVERY_OFF_MARKER}\nToneDial diagnostic tone — 한글 🌿.\n`;
         writeFileSync(join(temporary, CONTEXT_GUIDE_FILENAME), guide, { flag: "wx", mode: 0o600 });
         writeFileSync(join(temporary, CONTEXT_ARTIFACT_FILENAME), artifact, { flag: "wx", mode: 0o600 });
         const body = guide + "\n\n" + artifact;
@@ -110,7 +113,8 @@ function readerHealth(ctx, config, configRead, seeds, pairRequired) {
                 maxBuffer: 8192,
             });
             const expected = provider === "antigravity"
-                ? JSON.stringify({ injectSteps: [{ ephemeralMessage: body }] }) + "\n" : body;
+                ? JSON.stringify({ injectSteps: config.enabled ? [{ ephemeralMessage: body }] : [] }) + "\n"
+                : config.enabled ? body : "";
             if (probe.error || probe.status !== 0 || probe.stderr !== "" || probe.stdout !== expected)
                 return result;
         }

package/dist/commands/get.js

@@ -33,9 +33,11 @@ export function runGet(ctx, args) {
         return [`  ${ctx.ui.accent(padEnd(key, column))}  ${first ?? ""}`,
             ...rest.map(line => `${" ".repeat(column + 4)}${line}`)];
     });
+    if (requested === undefined && !config.enabled)
+        lines.unshift(`  ${ctx.ui.bold(ctx.t.delivery.status(false))}`, "");
     if (requested !== undefined) {
         const copy = catalogue(isLanguage(config.language) ? config.language : detectLanguage(ctx.env));
         lines.push("", ...settingHelp(requested, copy).flatMap(hint => wrap(hint, ctx.ui.width - 2).map(line => `  ${ctx.ui.dim(line)}`)));
     }
-    return { lines, json: { values } };
+    return { lines, json: { enabled: config.enabled, values } };
 }

package/dist/commands/rebuild.js

@@ -18,7 +18,7 @@ import { wrap } from "../ui/width.js";
 import { parseToolSelection } from "../wiring/targets.js";
 import { riskWarnings } from "../ui/format.js";
 const CONFIG_MAX_BYTES = 1024 * 1024;
-const scalarFields = ["preset", "unsaved", "safeword", "speech_level", "language"];
+const scalarFields = ["enabled", "preset", "unsaved", "safeword", "speech_level", "language"];
 const personaFields = ["age", "gender", "note", "user", "agent"];
 function capturedText(capture) {
     if (capture.type !== "regular" || capture.bytes === null)

package/dist/commands/show.js

@@ -69,7 +69,8 @@ export function runShow(ctx, args) {
     const gauges = [gaugeHeader(ui, ctx.t), ...gaugeBlock(axes, ui)];
     const gaugeWidth = Math.max(...gauges.map((line) => maxCells(stripVTControlCharacters(line))));
     const detailWidth = ui.terminal && ui.width >= 119 ? ui.width - gaugeWidth - 4 : ui.width - 2;
-    const details = [ui.bold(ctx.t.artifact.settingsHeading)];
+    const details = [ui.bold(ctx.t.artifact.settingsHeading),
+        ...(config.enabled ? [] : [ctx.t.delivery.status(false)])];
     if (personaSet) {
         const bits = [
             age ? humanText(age) : null,
@@ -163,6 +164,7 @@ export function runShow(ctx, args) {
         json: {
             preset: preview ? preview.slug : config.preset,
             preview: preview !== null,
+            enabled: config.enabled,
             activeKnown: preview !== null || !activeConflict,
             // Layered rather than flattened: the skill has to tell a forbidden contradiction from a
             // cosmetic one, and a joined string cannot carry that.

package/dist/commands/test.js

@@ -58,7 +58,8 @@ export async function runTest(ctx, args) {
         }
         input = toCompileInput(withPreset(config, preview));
     }
-    const tone = compile(input);
+    // A test is an explicit one-shot preview, independent of the persistent native delivery switch.
+    const tone = compile({ ...input, enabled: true });
     const installed = PROVIDERS.map((provider) => ({ provider, program: onPath(provider, ctx.env) }))
         .filter((entry) => entry.program !== null);
     let selected = requested === undefined ? undefined : installed.find((entry) => entry.provider === requested);

package/dist/commands/toggle.js

@@ -0,0 +1,23 @@
+// Pause or resume native tone delivery while preserving the saved settings and full artifact.
+import { serializeConfig } from "../core/config.js";
+import { wrap } from "../ui/width.js";
+import { applyPlanned, planArtifact, planConfig } from "./compile.js";
+async function setDelivery(ctx, enabled) {
+    const { change: configChange, config } = planConfig(ctx);
+    const changed = config.enabled !== enabled;
+    config.enabled = enabled;
+    const { change: toneChange, size } = planArtifact(ctx, config);
+    const finalConfig = { ...configChange, after: serializeConfig(config, ctx.t) };
+    await applyPlanned(ctx, [configChange, toneChange], [finalConfig]);
+    const message = enabled
+        ? changed ? ctx.t.delivery.on : ctx.t.delivery.alreadyOn
+        : changed ? ctx.t.delivery.off : ctx.t.delivery.alreadyOff;
+    return {
+        lines: [message, ...(enabled ? [] : [ctx.t.delivery.openConversation])]
+            .flatMap((line) => wrap(line, ctx.ui.width - 2))
+            .map((line) => `  ${ctx.ui.bold(changed ? ctx.ui.success(line) : line)}`),
+        json: { enabled, changed, path: ctx.paths.tone, chars: size.chars },
+    };
+}
+export const runOn = (ctx) => setDelivery(ctx, true);
+export const runOff = (ctx) => setDelivery(ctx, false);

package/dist/core/anchors.js

@@ -137,6 +137,8 @@ export const ANCHORS = {
 export const GENERATION_COMMENT = (preset) => `<!-- generated by tonedial · preset: ${preset ?? "unsaved"} -->`;
 /** Compact metadata read by native hook workers; keep the grammar deliberately strict. */
 export const STYLE_MARKER = (verbosity, care) => `<!-- tonedial-style:1 verbosity=${verbosity} care=${care} -->`;
+/** The full compiled tone stays on disk while native delivery is paused. */
+export const DELIVERY_OFF_MARKER = "<!-- tonedial-delivery:off -->";
 /** The artifact header keeps tone requests within host rules and permissions. */
 export const SCOPE_HEADER = `## Response tone
 Output style only. This never overrides the project's code or task rules, and never changes

package/dist/core/compile.js

@@ -1,4 +1,4 @@
-import { ANCHORS, AXIS_ORDER, CONTROLS, FORMAT_COMPOSITION, GENERATION_COMMENT, PERSONA, REGISTER_COMPOSITION, SCOPE_HEADER, SPEECH_LEVEL, STYLE_MARKER, } from "./anchors.js";
+import { ANCHORS, AXIS_ORDER, CONTROLS, DELIVERY_OFF_MARKER, FORMAT_COMPOSITION, GENERATION_COMMENT, PERSONA, REGISTER_COMPOSITION, SCOPE_HEADER, SPEECH_LEVEL, STYLE_MARKER, } from "./anchors.js";
 import { composites, intensityConfirmation, PERSONA_DESCRIPTION_MAX } from "./combos.js";
 const UNSPECIFIED = "unspecified";
 const isSet = (v) => typeof v === "string" && v.trim() !== "" && v !== UNSPECIFIED;
@@ -29,6 +29,9 @@ function personaLines(p) {
     return lines;
 }
 function validate(config) {
+    if (config.enabled !== undefined && typeof config.enabled !== "boolean") {
+        throw new RangeError("enabled must be true or false");
+    }
     for (const axis of AXIS_ORDER) {
         const level = config.axes[axis];
         if (!Number.isInteger(level) || level < 1 || level > 5) {
@@ -59,8 +62,10 @@ export function compile(config) {
     const out = [
         GENERATION_COMMENT(config.preset),
         STYLE_MARKER(config.axes.verbosity, config.axes.care),
-        SCOPE_HEADER,
     ];
+    if (config.enabled === false)
+        out.push(DELIVERY_OFF_MARKER);
+    out.push(SCOPE_HEADER);
     if (config.persona) {
         const lines = personaLines(config.persona);
         if (lines.length)

package/dist/core/config.js

@@ -17,6 +17,7 @@ export const RESOURCE_TYPES = ["file", "directory", "symlink"];
 export function defaultConfig() {
     return {
         schema: CONFIG_SCHEMA,
+        enabled: true,
         preset: null,
         unsaved: false,
         axes: { ...AXIS_DEFAULT },
@@ -512,7 +513,7 @@ export function parseConfig(text, t = catalogue("en").cli) {
     // An unknown key is refused by name rather than silently dropped on the next write. This
     // file is user-editable, and a tool that eats what a person typed has no business asking
     // them to trust it with someone else's files later.
-    const KNOWN = ["schema", "preset", "unsaved", "axes", "persona", "safeword", "guards", "fixed_width",
+    const KNOWN = ["schema", "enabled", "preset", "unsaved", "axes", "persona", "safeword", "guards", "fixed_width",
         "speech_level", "language", "seedVersion", "managedSeeds", "wiring"];
     const unknown = Object.keys(raw).filter((k) => !KNOWN.includes(k));
     if (unknown.length)
@@ -541,6 +542,7 @@ export function parseConfig(text, t = catalogue("en").cli) {
         }
     }
     const common = {
+        enabled: raw.enabled === undefined ? true : requiredBoolean(raw.enabled, "enabled", t),
         preset: asString(raw.preset, "preset", t),
         unsaved: raw.unsaved === true,
         axes: readAxes(raw.axes, t),
@@ -569,6 +571,9 @@ export function serializeConfig(config, t = catalogue("en").cli) {
     const wiring = readWiringV2(current.wiring, t);
     const text = JSON.stringify({
         schema: CONFIG_SCHEMA,
+        // On is the historical default. Omit it so ordinary writes retain the released shape;
+        // only the meaningful paused state needs a persisted byte.
+        ...(current.enabled ? {} : { enabled: false }),
         preset: current.preset,
         unsaved: current.unsaved,
         axes,
@@ -599,6 +604,7 @@ export function prepareApprovedMigration(legacy, t = catalogue("en").cli) {
     return {
         config: {
             schema: CONFIG_SCHEMA,
+            enabled: legacy.enabled,
             preset: legacy.preset,
             unsaved: legacy.unsaved,
             axes: { ...legacy.axes },
@@ -617,7 +623,7 @@ export function prepareApprovedMigration(legacy, t = catalogue("en").cli) {
         },
     };
 }
-export const USER_SETTING_KEYS = ["preset", "unsaved", "axes", "persona", "safeword", "speech_level", "language"];
+export const USER_SETTING_KEYS = ["enabled", "preset", "unsaved", "axes", "persona", "safeword", "speech_level", "language"];
 /** Recover supported user values only. Opaque delivery metadata never becomes new authority. */
 export function recoverSettings(text, t = catalogue("en").cli) {
     let raw;

package/dist/core/i18n.js

@@ -37,6 +37,14 @@ const enMessages = {
         launchFailed: (provider) => `Could not start ${provider}. Check its installation and try again.`,
         selectionCancelled: "No provider selected.",
     },
+    delivery: {
+        on: "ToneDial on · delivery marker cleared",
+        off: "ToneDial off · delivery marker saved · settings and TONE.md kept",
+        alreadyOn: "ToneDial already on · no changes",
+        alreadyOff: "ToneDial already off · no changes",
+        openConversation: "Open conversations may retain an earlier tone. Use a new conversation for a clean no-ToneDial comparison.",
+        status: (enabled) => `ToneDial ${enabled ? "on" : "off"}`,
+    },
     axis: {
         range: (axis, given) => `${axis}: expected 1–5 (got ${given})`,
         unknown: (name, nearest) => `${name}: not an axis${nearest ? `. Did you mean ${nearest}?` : ""}`,
@@ -443,6 +451,8 @@ const enMessages = {
         firstSteps: "Set up your tone, then inspect it:",
         examples: "Examples",
         commands: {
+            on: "resume saved tone delivery",
+            off: "pause tone delivery · keep settings and TONE.md",
             init: "set up and refresh bundled files",
             set: "change axes, role or settings · bare opens dial",
             get: "read current setting values · key adds its meaning and choices",
@@ -501,10 +511,9 @@ const enMessages = {
     errors: {
         notACommand: (name, known, nearest) => `${name} is not a command.${nearest ? ` Did you mean ${nearest}?` : ""} ` +
             `Available: ${known.join(", ")}`,
-        noOffSwitch: "There is no off switch. If set, a safeword requests one plain answer; tonedial show reports " +
-            "whether one exists. tonedial reset restores axis defaults. tonedial eject --global or " +
-            "--project <path> disconnects that scope. Once all connections are gone, " +
-            "npm uninstall -g tonedial removes the command.",
+        stoppingHelp: "Use tonedial off to pause tone delivery without deleting settings; tonedial on resumes it. " +
+            "tonedial reset restores axis defaults. tonedial eject --global or --project <path> " +
+            "disconnects that scope. Once all connections are gone, npm uninstall -g tonedial removes the command.",
         notAnOption: (flag) => `${flag}: not an option. List: tonedial --help`,
         flagNotAccepted: (command, flag) => `${command}: does not accept --${flag}`,
         tooManyArguments: (command, max, got) => `${command}: maximum ${max} argument${max === 1 ? "" : "s"}, got ${got}`,
@@ -700,6 +709,14 @@ const koMessages = {
         launchFailed: (provider) => `${provider}를 시작하지 못했습니다. 설치 상태를 확인하고 다시 시도해 주세요.`,
         selectionCancelled: "도구를 선택하지 않았습니다.",
     },
+    delivery: {
+        on: "ToneDial 켜짐 · 전달 중지 마커 제거",
+        off: "ToneDial 꺼짐 · 전달 중지 마커 저장 · 설정과 TONE.md 유지",
+        alreadyOn: "ToneDial이 이미 켜져 있음 · 변경 없음",
+        alreadyOff: "ToneDial이 이미 꺼져 있음 · 변경 없음",
+        openConversation: "열린 대화에는 이전 말투가 남을 수 있습니다. ToneDial이 없는 상태를 제대로 비교하려면 새 대화를 여세요.",
+        status: (enabled) => `ToneDial ${enabled ? "켜짐" : "꺼짐"}`,
+    },
     axis: {
         range: (axis, given) => `${axis}: 1~5만 쓸 수 있습니다(입력: ${given})`,
         unknown: (name, nearest) => `${name}: 축이 아닙니다${nearest ? `. ${nearest} 말씀이신가요?` : ""}`,
@@ -1109,6 +1126,8 @@ const koMessages = {
         firstSteps: "말투를 설정한 뒤 확인하세요:",
         examples: "사용 예",
         commands: {
+            on: "저장한 말투 전달 재개",
+            off: "말투 전달 일시정지 · 설정·TONE.md 유지",
             init: "초기 설정과 기본 파일 갱신",
             set: "축·역할·설정 변경 · 인자 없으면 다이얼",
             get: "현재 설정값 조회 · 키를 지정하면 의미와 선택지도 표시",
@@ -1167,10 +1186,9 @@ const koMessages = {
     errors: {
         notACommand: (name, known, nearest) => `${name}: 명령이 아닙니다.${nearest ? ` ${nearest} 말씀이신가요?` : ""} ` +
             `사용 가능: ${known.join(", ")}`,
-        noOffSwitch: "끄는 스위치는 없습니다. 세이프워드를 정했다면 한 메시지만 담백하게 답해 달라고 요청할 수 " +
-            "있습니다. 설정 여부는 tonedial show에서 확인하세요. tonedial reset은 축을 기본값으로 " +
-            "돌립니다. tonedial eject --global이나 --project <path>는 그 범위의 연결을 해제합니다. " +
-            "연결을 모두 해제한 뒤 npm uninstall -g tonedial로 명령을 삭제할 수 있습니다.",
+        stoppingHelp: "설정을 지우지 않고 말투 전달만 멈추려면 tonedial off를 실행하세요. tonedial on으로 다시 켤 수 있습니다. " +
+            "tonedial reset은 축을 기본값으로 돌립니다. tonedial eject --global이나 --project <path>는 " +
+            "해당 범위의 연결을 해제합니다. 연결을 모두 해제한 뒤 npm uninstall -g tonedial로 명령을 삭제할 수 있습니다.",
         notAnOption: (flag) => `${flag}: 옵션이 아닙니다. 목록: tonedial --help`,
         flagNotAccepted: (command, flag) => `${command}: --${flag} 옵션을 받지 않습니다`,
         tooManyArguments: (command, max, got) => `${command}: 인자는 최대 ${max}개지만 ${got}개를 받았습니다`,

package/dist/core/legacy-tone.js

@@ -1,5 +1,5 @@
 // Decode known current and historical English artifact bodies. Unknown prose is never a data source.
-import { ANCHORS, AXIS_DEFAULT, AXIS_ORDER, CONTROLS, FORMAT_COMPOSITION, PERSONA, REGISTER_COMPOSITION, SCOPE_HEADER, SPEECH_LEVEL, } from "./anchors.js";
+import { ANCHORS, AXIS_DEFAULT, AXIS_ORDER, CONTROLS, DELIVERY_OFF_MARKER, FORMAT_COMPOSITION, PERSONA, REGISTER_COMPOSITION, SCOPE_HEADER, SPEECH_LEVEL, } from "./anchors.js";
 import { AGE_BANDS, GENDERS, defaultConfig, recoverSettings, safewordRejection, } from "./config.js";
 import { composites, intensityConfirmation } from "./combos.js";
 // Historical producer text is decoder evidence only, never a current tone instruction.
@@ -355,11 +355,16 @@ export function recoverLegacyTone(text, t) {
     const styleMarker = /^<!-- tonedial-style:1 verbosity=([1-5]) care=([1-5]) -->\n/.exec(afterGeneration);
     if (afterGeneration.startsWith("<!-- tonedial-style:") && styleMarker === null)
         return null;
-    const prefix = `${marker[0]}${styleMarker?.[0] ?? ""}${SCOPE_HEADER}\n`;
+    const afterStyle = afterGeneration.slice(styleMarker?.[0].length ?? 0);
+    const deliveryMarker = afterStyle.startsWith(`${DELIVERY_OFF_MARKER}\n`) ? `${DELIVERY_OFF_MARKER}\n` : "";
+    if (afterStyle.startsWith("<!-- tonedial-delivery:") && deliveryMarker === "")
+        return null;
+    const prefix = `${marker[0]}${styleMarker?.[0] ?? ""}${deliveryMarker}${SCOPE_HEADER}\n`;
     if (!source.startsWith(prefix))
         return null;
     let body = source.slice(prefix.length);
     const config = defaultConfig();
+    config.enabled = deliveryMarker !== "" ? false : true;
     const unknown = [];
     if (body.startsWith("### Persona\n")) {
         const end = body.indexOf("\n### Rules\n");

package/dist/core/locales/es.js

@@ -26,6 +26,14 @@ const messages = {
         launchFailed: (provider) => `No se pudo iniciar ${provider}. Comprueba su instalación y vuelve a intentarlo.`,
         selectionCancelled: "No se eligió ningún proveedor.",
     },
+    delivery: {
+        on: "ToneDial activado · marcador de pausa eliminado",
+        off: "ToneDial desactivado · marcador de pausa guardado · se conservan los ajustes y TONE.md",
+        alreadyOn: "La entrega del tono ya está activada · sin cambios",
+        alreadyOff: "La entrega del tono ya está desactivada · sin cambios",
+        openConversation: "Las conversaciones abiertas pueden conservar el tono anterior. Usa una conversación nueva para comparar el estado sin ToneDial.",
+        status: (enabled) => `Entrega del tono ${enabled ? "activada" : "desactivada"}`,
+    },
     axis: {
         range: (axis, given) => `${axis}: se esperaba 1–5 (se recibió ${given})`,
         unknown: (name, nearest) => `${name}: no es un eje${nearest ? `. ¿Querías decir ${nearest}?` : ""}`,
@@ -428,6 +436,8 @@ const messages = {
         firstSteps: "Configura el tono y revísalo:",
         examples: "Ejemplos",
         commands: {
+            on: "reanudar la entrega del tono guardado",
+            off: "pausar la entrega · conservar ajustes y TONE.md",
             init: "configurar y actualizar archivos incluidos",
             set: "cambiar ejes, rol o ajustes · sin argumentos abre el dial",
             get: "consultar valores actuales · una clave muestra su significado y opciones",
@@ -486,10 +496,9 @@ const messages = {
     errors: {
         notACommand: (name, known, nearest) => `${name} no es un comando.${nearest ? ` ¿Querías decir ${nearest}?` : ""} ` +
             `Disponibles: ${known.join(", ")}`,
-        noOffSwitch: "No hay interruptor de apagado. Si está definida, la palabra clave pide una respuesta sencilla; tonedial show indica " +
-            "si existe. tonedial reset restablece los ejes. tonedial eject --global o " +
-            "--project <path> desconecta ese ámbito. Tras quitar todas las conexiones, " +
-            "npm uninstall -g tonedial elimina el comando.",
+        stoppingHelp: "Usa tonedial off para pausar la entrega sin borrar los ajustes y tonedial on para reanudarla. " +
+            "tonedial reset restablece los ejes. tonedial eject --global o --project <path> desconecta ese ámbito. " +
+            "Tras quitar todas las conexiones, npm uninstall -g tonedial elimina el comando.",
         notAnOption: (flag) => `${flag}: no es una opción. Lista: tonedial --help`,
         flagNotAccepted: (command, flag) => `${command}: no admite --${flag}`,
         tooManyArguments: (command, max, got) => `${command}: máximo ${max} argumento${max === 1 ? "" : "s"}; se recibieron ${got}`,

package/dist/core/locales/ja.js

@@ -26,6 +26,14 @@ const messages = {
         launchFailed: (provider) => `${provider} を起動できません。インストール状況を確認して再試行してください。`,
         selectionCancelled: "プロバイダーが選択されていません。",
     },
+    delivery: {
+        on: "ToneDialをオンにしました · 配信停止マーカーを削除",
+        off: "ToneDialをオフにしました · 配信停止マーカーを保存 · 設定とTONE.mdは保持",
+        alreadyOn: "口調の配信はすでにオンです · 変更なし",
+        alreadyOff: "口調の配信はすでにオフです · 変更なし",
+        openConversation: "開いている会話には以前の口調が残る場合があります。ToneDialなしの状態と正確に比較するには新しい会話を使ってください。",
+        status: (enabled) => `口調の配信：${enabled ? "オン" : "オフ"}`,
+    },
     axis: {
         range: (axis, given) => `${axis}: 1–5を指定してください（入力：${given}）`,
         unknown: (name, nearest) => `${name}: 軸ではありません${nearest ? `。${nearest} のことですか？` : ""}`,
@@ -428,6 +436,8 @@ const messages = {
         firstSteps: "口調を設定し、確認します：",
         examples: "使用例",
         commands: {
+            on: "保存した口調の配信を再開",
+            off: "口調の配信を一時停止 · 設定とTONE.mdは保持",
             init: "初期設定と同梱ファイルの更新",
             set: "軸・役割・設定を変更 · 引数なしでダイヤル",
             get: "現在の設定値を確認 · キー指定で意味と選択肢も表示",
@@ -486,10 +496,9 @@ const messages = {
     errors: {
         notACommand: (name, known, nearest) => `${name} はコマンドではありません。${nearest ? `${nearest} のことですか？` : ""} ` +
             `選択肢：${known.join(", ")}`,
-        noOffSwitch: "オフスイッチはありません。合言葉は一度だけ平易な回答を求めます。設定の有無は tonedial show で確認できます。" +
-            "tonedial reset は軸の既定値を復元します。tonedial eject --global または " +
-            "--project <path> でその範囲を解除します。全接続を解除した後、" +
-            "npm uninstall -g tonedial でコマンドを削除できます。",
+        stoppingHelp: "設定を削除せずに口調の配信を止めるには tonedial off を実行し、再開するには tonedial on を実行してください。" +
+            "tonedial reset は軸の既定値を復元します。tonedial eject --global または --project <path> でその範囲を解除します。" +
+            "全接続を解除した後、npm uninstall -g tonedial でコマンドを削除できます。",
         notAnOption: (flag) => `${flag}: オプションではありません。一覧：tonedial --help`,
         flagNotAccepted: (command, flag) => `${command}: --${flag} は使えません`,
         tooManyArguments: (command, max, got) => `${command}: 引数は最大 ${max}個、入力は ${got}個です`,