tonedial 0.1.6 → 0.1.7

package/dist/core/locales/zh.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} 个`,

package/dist/core/reader.js

@@ -1,6 +1,7 @@
 // Hooks may run without PATH or after the package moves. The seeded reader is standalone.
 import { CONTEXT_ARTIFACT_FILENAME, CONTEXT_GUIDE_FILENAME, } from "./paths.js";
-export const READER_PROTOCOL_VERSION = 2;
+import { DELIVERY_OFF_MARKER } from "./anchors.js";
+export const READER_PROTOCOL_VERSION = 3;
 export const GUIDE_FORMAT_VERSION = 1;
 export const GUIDE_FORMAT_MARKER = `<!-- tonedial-guide:${GUIDE_FORMAT_VERSION} -->`;
 /** Stable, short repair guidance shared by the emitted source and diagnostics. */
@@ -25,6 +26,7 @@ export const READER_REPAIR_HINTS = {
     event: "use a supported hook event",
     input: "retry the hook with a valid event payload",
     response: "retry the hook when the response is available",
+    "delivery-marker": "regenerate the tone artifact",
     "style-marker": "regenerate the tone artifact",
     unreadable: "run tonedial doctor and resolve the reported path",
 };
@@ -50,6 +52,7 @@ const GUIDE_FILENAME = ${JSON.stringify(CONTEXT_GUIDE_FILENAME)};
 const ARTIFACT_FILENAME = ${JSON.stringify(CONTEXT_ARTIFACT_FILENAME)};
 const LOCK_FILENAME = "operations.lock";
 const GUIDE_MARKER = ${JSON.stringify(GUIDE_FORMAT_MARKER)};
+const DELIVERY_OFF_MARKER = ${JSON.stringify(DELIVERY_OFF_MARKER)};
 const REPAIR_HINTS = ${JSON.stringify(READER_REPAIR_HINTS)};
 const PROVIDERS = new Set(["codex", "claude", "antigravity"]);
 const EVENTS = new Set(["SessionStart", "UserPromptSubmit", "Stop", "PreInvocation"]);
@@ -338,6 +341,13 @@ function styleMarker(artifact) {
   return match === null ? null : { verbosity: Number(match[1]), care: Number(match[2]) };
 }
 
+function deliveryEnabled(artifact) {
+  const line = artifact.split(/\r?\n/, 3)[2] ?? "";
+  if (line === DELIVERY_OFF_MARKER) return false;
+  if (line.startsWith("<!-- tonedial-delivery:")) throw new ReaderFailure("delivery-marker");
+  return true;
+}
+
 // shortcut: ambiguous data-like prose skips feedback; refine only with verified host format metadata.
 function literalPayload(text) {
   const value = text.trim();
@@ -400,8 +410,12 @@ async function main() {
   const hint = providerHint(args);
   try {
     const { provider, state, event } = parseArgs(args);
-    const input = event === "Stop" ? await hookInput() : null;
     const pair = readPair(state);
+    if (!deliveryEnabled(pair.artifact)) {
+      empty(provider, event);
+      return;
+    }
+    const input = event === "Stop" ? await hookInput() : null;
     if (event === "Stop") {
       const result = styleFeedback(pair, input);
       if (result.diagnostic !== null) {

package/dist/core/resolve.js

@@ -5,6 +5,7 @@ export function toCompileInput(stored) {
         // The slug rides in the generation comment, so the model reads it. `unsaved` is what the
         // artifact says once tone settings have moved away from the profile that named them.
         preset: stored.unsaved ? null : stored.preset,
+        ...(stored.enabled ? {} : { enabled: false }),
         axes: stored.axes,
         speech_level: stored.speech_level,
         persona: hasPersona ? p : null,

package/dist/core/seeds.js

@@ -11,13 +11,13 @@ import { captureRawEntry, caseRenameMatchesCurrent, isNoop, planChange, planEntr
 import { BUNDLED, builtinPresetDir, LEGACY_BUILTIN_SLUGS, RETIRED_PRESETS } from "./presets.js";
 import { SKILL_MD, SKILL_NAME, SKILL_TRAITS_MD } from "./skill.js";
 // Bump for changed generated content; freshness also checks each managed seed's bytes/provenance.
-export const SEED_VERSION = 23;
+export const SEED_VERSION = 24;
 /** The state-root operating boundaries. The compiler owns the current tone separately. */
 export const GUIDE_MD = `${GUIDE_FORMAT_MARKER}
 ToneDial changes manner only; it never expands task scope or permissions.
 Use the ToneDial CLI for configuration changes.
 AGENTS.md is the operating guide, TONE.md is the current compiled tone, and the ToneDial skill
-explains explicit in-session tuning and reloads.
+explains delivery controls, explicit in-session tuning and reloads.
 `;
 /** Existing generated runtime families are repaired without inferring any native connection. */
 export function generatedSeedSelection(paths, config, native, t = catalogue("en").cli) {
@@ -73,7 +73,7 @@ export function seedFiles(paths, selection) {
     };
     const native = [
         reader,
-        { id: "skill/body", version: 21, path: join(paths.skill, SKILL_NAME, "SKILL.md"), label: `skill/${SKILL_NAME}/SKILL.md`, contents: SKILL_MD },
+        { id: "skill/body", version: 22, path: join(paths.skill, SKILL_NAME, "SKILL.md"), label: `skill/${SKILL_NAME}/SKILL.md`, contents: SKILL_MD },
         {
             id: "skill/traits",
             version: 12,

package/dist/core/skill.js

@@ -5,6 +5,7 @@ export const SKILL_NAME = "tonedial";
 /** The current command envelope, shared by both installed control entry points. */
 const JSON_MD = `Require zero exit status and a JSON result with \`ok: true\` and \`schema: 3\`
 for every successful CLI step before continuing. Parse JSON rather than scraping human output.
+\`get --json\`, \`show --json\`, and \`compile --check --json\` report the shared \`enabled\` delivery state.
 \`chars\` reports the current TONE.md Unicode character count; no size target or maximum applies.
 Schema 3 removes guard and ceiling fields and reports advisory \`riskAxes\`; persisted config
 remains schema 2. Custom profiles use preset schema 2; legacy schema 1 and journal formats
@@ -65,6 +66,10 @@ Require zero exit status, \`ok: true\`, and \`schema: 3\` before continuing.
 This read-only command reports destinations; it does not prove that either file exists,
 matches the saved settings, or has been loaded.
 
+If it reports \`enabled: false\`, do not read or apply the context pair. Report that the settings
+are saved but delivery remains off. This also applies to tone changes made while delivery is off.
+Continue below only when it reports \`enabled: true\`.
+
 Read the complete UTF-8 file at the returned absolute \`agentsPath\` first (\`AGENTS.md\`).
 Its first line must be \`${GUIDE_FORMAT_MARKER}\`; otherwise stop the reload.
 Then read the complete UTF-8 file at the returned absolute \`path\` (\`TONE.md\`).
@@ -86,6 +91,22 @@ This reload affects only the current conversation. It does not fire a lifecycle
 earlier context, or reload other open sessions. Future delivery still depends on an installed,
 enabled, and trusted native hook.
 `;
+const DELIVERY_MD = `## Pause and resume delivery
+
+For an explicit request to turn ToneDial off, run \`tonedial off --json\`, then run
+\`tonedial compile --check --json\`. Require both results to report \`enabled: false\`.
+Do not read the guide or artifact afterward. Report that saved settings, profiles and the full
+\`TONE.md\` remain. The current ToneDial reader emits no ToneDial context.
+Already delivered context cannot be removed from an open conversation; stop applying the saved
+manner where possible and name a fresh conversation as the clean check. Do not promise a perfect reset.
+The successful command proves the marker was saved, not that a native reader ran.
+A reader installed before this switch must be refreshed through the user's existing tools and scope
+before it can honor the marker.
+
+For an explicit request to turn ToneDial on, run \`tonedial on --json\`, then follow the reload
+procedure below. Turning delivery on does not prove that a native hook is installed, trusted,
+enabled or running. Neither command changes axes, persona, address, register, safeword or profiles.
+`;
 /** Explicit setting requests use the same CLI mapping through either installed entry point. */
 const SETTINGS_MD = `## Explicit settings
 
@@ -220,7 +241,7 @@ Do not claim that setup, repair, or migration proves host activation or model ad
  */
 export const SKILL_MD = `---
 name: tonedial
-description: Use when the user wants to check, change, or reload ToneDial manner, tone, personality, register, preset, user description, agent role, address terms, or safeword — including requests like "be gentler", "act as a database specialist", "remember my background in ToneDial", "more formal", "call me friend", or asking what the current tone settings are.
+description: Use when the user wants to check, change, pause, resume, or reload ToneDial manner, tone, personality, register, preset, user description, agent role, address terms, or safeword — including requests like "turn ToneDial off", "be gentler", "act as a database specialist", "remember my background in ToneDial", "more formal", "call me friend", or asking what the current tone settings are.
 ---
 
 # tonedial
@@ -239,6 +260,7 @@ the user to complete CLI installation and explicit setup; do not install it or g
 tonedial get --json
 \`\`\`
 
+The top-level \`enabled\` field reports whether native delivery is on.
 The \`values\` object carries the twelve axis levels and the separate settings under their
 editable keys. An unset setting is \`null\`; description text is returned in full.
 For the formatted overview, preset state and advisory \`riskAxes\`, use \`tonedial show --json\`.
@@ -283,9 +305,11 @@ ${SETTINGS_MD}
 
 ${SETUP_MD}
 
+${DELIVERY_MD}
+
 ## Apply it in this session
 
-Successful \`set\`, \`address\`, \`persona\`, \`use\`, \`reset\`, \`save\`, and approved \`create\` commands recompile \`TONE.md\`; that is a saved state
+Successful \`on\`, \`off\`, \`set\`, \`address\`, \`persona\`, \`use\`, \`reset\`, \`save\`, and approved \`create\` commands recompile \`TONE.md\`; that is a saved state
 change, not evidence of a session reload.
 
 ${RELOAD_MD}
@@ -300,9 +324,9 @@ in the same message still faces every confirmation and permission check it other
 For an explicit request to restore the default axes, run \`tonedial reset --json\`, then follow
 the reload steps above. Saved presets remain available through \`tonedial use <slug> --json\`.
 Reset restores axes only; it does not disable hooks, unload instructions, or clear persona,
-safeword, or other settings. ToneDial has no persistent tone-off switch.
-For "turn tone off" or an ambiguous "go back to normal", explain that limit and ask whether
-the user wants an axis reset before changing state; do not silently equate off with reset.
+safeword, or other settings. Use \`tonedial off --json\` to pause delivery without changing them.
+For an ambiguous "go back to normal", ask whether the user means delivery off or an axis reset;
+do not silently equate them.
 
 ## A separate test conversation
 
@@ -458,12 +482,13 @@ selected by critique or persona. Bravado grades effort claims without replacing
  * command name stays `/tone` even though the tool is `tonedial`: it is what a person types
  * mid-sentence, and the two extra characters are paid every time.
  */
-export const TONE_COMMAND_VERSION = 15;
+export const TONE_COMMAND_VERSION = 16;
 export const TONE_COMMAND_MD = `---
-description: Check, change, or reload this agent's tone, preset, or ToneDial settings
+description: Check, change, pause, resume, or reload this agent's tone, preset, or ToneDial settings
 ---
 
-Run \`tonedial get --json\` and report the requested current settings from \`values\` in plain language.
+Run \`tonedial get --json\` and report the requested current settings from \`values\` and the
+delivery state from \`enabled\` in plain language.
 Use the same installed CLI and environment throughout.
 ${JSON_MD}
 Otherwise report the failed step and stop that flow.
@@ -485,13 +510,15 @@ ${SETTINGS_MD}
 
 ${SETUP_MD}
 
+${DELIVERY_MD}
+
 ${RELOAD_MD}
 
 An explicit axis-reset request uses \`tonedial reset --json\` followed by the same reload steps.
 Reset restores axes only; it does not disable hooks, unload instructions, or clear persona,
 safeword, or other settings. Saved presets remain available.
-\`/tone off\` is not a persistent tone-off switch. Explain that limit and ask whether the user
-wants an axis reset before changing state; never silently equate off with reset.
+For an ambiguous \`/tone normal\`, ask whether the user means delivery off or an axis reset;
+never silently equate them.
 
 Never edit ToneDial's config, guide, or artifact directly; the CLI is the source of truth.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonedial",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Set a coding agent's manner once and keep it across every project.",
   "license": "MIT",
   "type": "module",