context-brake 1.0.0 → 1.1.0

package/dist/assets/runtime/claude-code-hook.mjs

@@ -4,6 +4,17 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/core/services/skill-invocation.ts
+function slashInvocation(skill) {
+  return `/${skill}`;
+}
+function sentenceInvocation(skill) {
+  return `use the ${skill} skill`;
+}
+
+// src/infrastructure/harnesses/claude-code/skill-invocation.ts
+var CLAUDE_SKILL_INVOCATION = slashInvocation;
+
 // node_modules/zod/v4/mini/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -5029,7 +5040,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve6) {
+function isRecursive(inst, stack, resolve7) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5039,7 +5050,7 @@ function isRecursive(inst, stack, resolve6) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve6);
+      const answer = isRecursive(child, stack, resolve7);
       if (answer > result)
         result = answer;
     }
@@ -5050,7 +5061,7 @@ function isRecursive(inst, stack, resolve6) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve6) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve7) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5114,7 +5125,7 @@ function isRecursive(inst, stack, resolve6) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve7 ? inst._zod.innerType : void 0);
       merge3(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -18155,6 +18166,34 @@ var HARNESS_IDS = [
   "antigravity-cli"
 ];
 
+// src/core/contracts/skill-name.ts
+var MAX_SKILL_NAME_LENGTH = 64;
+var NAME_SEGMENT = "[a-z0-9]+(?:-[a-z0-9]+)*";
+var NAMESPACE_SEPARATOR = ":";
+var INVOCATION_CHARACTERS = ["/", "$", "@"];
+var MAX_QUALIFIED_LENGTH = MAX_SKILL_NAME_LENGTH * 2 + NAMESPACE_SEPARATOR.length;
+function segmentFits(end) {
+  return `(?=[^${NAMESPACE_SEPARATOR}]{1,${MAX_SKILL_NAME_LENGTH}}${end})`;
+}
+var PREFIX = `(?:${segmentFits(NAMESPACE_SEPARATOR)}${NAME_SEGMENT}${NAMESPACE_SEPARATOR})?`;
+var SKILL_NAME_PATTERN = new RegExp(`^${PREFIX}${segmentFits("$")}${NAME_SEGMENT}$`);
+var SHAPE_RULE = `lowercase letters, digits, and single hyphens, up to ${MAX_SKILL_NAME_LENGTH} characters, optionally prefixed by a plugin name and a colon`;
+function isSkillName(value) {
+  return SKILL_NAME_PATTERN.test(value);
+}
+function skillNameProblem(value) {
+  if (value === "") return "must not be empty";
+  if (isSkillName(value)) return null;
+  const bare = INVOCATION_CHARACTERS.includes(value.charAt(0)) ? value.slice(1) : null;
+  if (bare !== null && isSkillName(bare)) return `"${value}" is not a skill name; use the bare name ${bare}`;
+  return `"${value}" is not a skill name; use ${SHAPE_RULE}`;
+}
+var skillNameSchema = external_exports.string().check((ctx) => {
+  const message = skillNameProblem(ctx.value);
+  if (message !== null) ctx.issues.push({ code: "custom", input: ctx.value, message });
+});
+external_exports.globalRegistry.add(skillNameSchema, { pattern: SKILL_NAME_PATTERN.source, maxLength: MAX_QUALIFIED_LENGTH });
+
 // src/core/contracts/zones.ts
 var ZONES = ["GREEN", "YELLOW", "RED", "CRITICAL"];
 var USAGE_SOURCES = ["measured", "estimated"];
@@ -18178,15 +18217,8 @@ function uniqueCheck(message) {
     if (!isUnique(ctx.value)) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message });
   };
 }
-var MAX_AGENT_COMMAND_LENGTH = 200;
-var TRIMMED_RULE = "must not have leading or trailing whitespace";
 var RESUME_REQUIRES_COMMAND_RULE = "requires snapshot.command";
-var SINGLE_LINE_RULE = "must be a single line";
-var agentCommand = external_exports.string().check(external_exports.minLength(1), external_exports.maxLength(MAX_AGENT_COMMAND_LENGTH), (ctx) => {
-  if (ctx.value.trim() !== ctx.value) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message: TRIMMED_RULE });
-  if (/[\r\n]/.test(ctx.value)) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message: SINGLE_LINE_RULE });
-});
-var snapshotSchema = external_exports.strictObject({ triggerZone: external_exports._default(external_exports.enum(SNAPSHOT_TRIGGER_ZONES), "RED"), command: external_exports.optional(agentCommand), resumeCommand: external_exports.optional(agentCommand) }).check((ctx) => {
+var snapshotSchema = external_exports.strictObject({ triggerZone: external_exports._default(external_exports.enum(SNAPSHOT_TRIGGER_ZONES), "RED"), triggerPercentage: external_exports.optional(external_exports.int().check(external_exports.minimum(1), external_exports.maximum(100))), command: external_exports.optional(skillNameSchema), resumeCommand: external_exports.optional(skillNameSchema) }).check((ctx) => {
   if (ctx.value.resumeCommand !== void 0 && ctx.value.command === void 0) addIssue(ctx, { code: "custom", path: ["resumeCommand"], input: ctx.value.resumeCommand, message: RESUME_REQUIRES_COMMAND_RULE });
 });
 var DEFAULT_SNAPSHOT = { triggerZone: "RED" };
@@ -18267,21 +18299,25 @@ var GENERIC_ACTIONS = {
   RED: "finish or pause the current unit and tell the user what remains",
   CRITICAL: "stop starting new work; tell the user what remains"
 };
-function zoneAction(zone, snapshot, mode = "off") {
-  if (zone === "GREEN" || !isAtOrAbove(zone, snapshot.triggerZone)) return GENERIC_ACTIONS[zone];
-  if (snapshot.command !== void 0) return snapshotAction(zone, snapshot.command);
-  if (mode !== "handoff") return GENERIC_ACTIONS[zone];
+function isResetDue(reading, snapshot) {
+  if (snapshot.triggerPercentage !== void 0) return reading.usagePercentage >= snapshot.triggerPercentage;
+  return reading.zone !== "GREEN" && isAtOrAbove(reading.zone, snapshot.triggerZone);
+}
+function zoneAction(zone, snapshot, options = {}) {
+  if (!isResetDue({ zone, usagePercentage: options.usagePercentage ?? 0 }, snapshot)) return GENERIC_ACTIONS[zone];
+  if (snapshot.command !== void 0) return snapshotAction(zone, (options.invoke ?? sentenceInvocation)(snapshot.command));
+  if ((options.mode ?? "off") !== "handoff") return GENERIC_ACTIONS[zone];
   return `save handoff to ${HANDOFF_PATH}, end reply with ${SESSION_RESET_SIGNAL}`;
 }
-function snapshotAction(zone, command) {
+function snapshotAction(zone, invocation) {
   const now = zone === "CRITICAL" ? " now" : "";
-  return `run "${command}"${now}, then end reply with ${SESSION_RESET_SIGNAL}`;
+  return `run "${invocation}"${now}, then end reply with ${SESSION_RESET_SIGNAL}`;
 }
 function handoffResumeText(archivedPath) {
   return `${RESUME_PREFIX} Read "${archivedPath}" and continue the previous work from it.`;
 }
-function resumeText(snapshot) {
-  return snapshot.resumeCommand === void 0 ? null : `${RESUME_PREFIX} Run "${snapshot.resumeCommand}" before continuing.`;
+function resumeText(snapshot, invoke = sentenceInvocation) {
+  return snapshot.resumeCommand === void 0 ? null : `${RESUME_PREFIX} Run "${invoke(snapshot.resumeCommand)}" before continuing.`;
 }
 function isAtOrAbove(zone, trigger) {
   return ZONES.indexOf(zone) >= ZONES.indexOf(trigger);
@@ -18326,7 +18362,7 @@ async function resolveFailure(input2) {
   return { kind: "neutral" };
 }
 function deadlineBootDecision(input2) {
-  const text = resumeText((input2.config ?? DEFAULT_CONFIG).snapshot);
+  const text = resumeText((input2.config ?? DEFAULT_CONFIG).snapshot, input2.descriptor?.skillInvocation);
   return text === null ? { kind: "neutral" } : { kind: "context", block: text };
 }
 async function recordRuntimeFailure(errors, record2) {
@@ -18447,7 +18483,7 @@ function isDebugModeInEffect(config2) {
 
 // src/core/services/injection-policy.ts
 function decideInjection(input2) {
-  if (input2.debug || input2.telemetry.injectionMode === "always") return true;
+  if (input2.debug || input2.resetDue === true || input2.telemetry.injectionMode === "always") return true;
   return input2.zone !== "GREEN" || input2.usagePercentage >= input2.telemetry.activationThresholdPercentage;
 }
 
@@ -18598,7 +18634,7 @@ async function handleSessionReset(options, event, hooks = {}) {
   if (!options.descriptor.capabilities.some((entry) => entry.id === "session_boot" && entry.state === "supported")) return NEUTRAL;
   if (event.reason === "compact" && !COMPACTION_BOOT_HARNESSES.includes(options.descriptor.harness)) return NEUTRAL;
   hooks.onPhase?.("guidance");
-  const text = resumeText(options.config.snapshot) ?? await claimHandoff(options, event.reason, hooks.deadline);
+  const text = resumeText(options.config.snapshot, options.descriptor.skillInvocation) ?? await claimHandoff(options, event.reason, hooks.deadline);
   return text === null ? NEUTRAL : { kind: "context", block: text };
 }
 async function claimHandoff(options, reason, deadline) {
@@ -18640,8 +18676,9 @@ async function handlePreInvocation(options, event, input2) {
   return telemetryDecision(options, summary.turns, readZone(options, { summary, turns: summary.turns, observedCharacters: 0, measured: input2.measured }));
 }
 async function telemetryDecision(options, turn, view) {
-  if (!decideInjection({ telemetry: options.config.telemetry, zone: view.zone, usagePercentage: view.percentage, debug: isDebugModeInEffect(options.config) })) return NEUTRAL2;
-  const action = zoneAction(view.zone, options.config.snapshot, restartMode(options.config));
+  const resetDue = isResetDue({ zone: view.zone, usagePercentage: view.percentage }, options.config.snapshot);
+  if (!decideInjection({ telemetry: options.config.telemetry, zone: view.zone, usagePercentage: view.percentage, debug: isDebugModeInEffect(options.config), resetDue })) return NEUTRAL2;
+  const action = zoneAction(view.zone, options.config.snapshot, { mode: restartMode(options.config), invoke: options.descriptor.skillInvocation, usagePercentage: view.percentage });
   return { kind: "context", block: renderTelemetryBlock({ turn, turnCeiling: redStartTurn(options.config.telemetry.zones), usagePercentage: view.percentage, usage: view.reading, zone: view.zone, action, debug: isDebugModeInEffect(options.config) }) };
 }
 async function handleResponseEnd(options, event) {
@@ -18675,6 +18712,26 @@ import { createHash } from "node:crypto";
 import { mkdir, writeFile } from "node:fs/promises";
 import { join as join2, resolve as resolve3 } from "node:path";
 
+// src/core/contracts/context-reading.ts
+var CONTEXT_READINGS_RELATIVE_DIR = ".context-brake/runtime/context-readings";
+var CONTEXT_READING_MAXIMUM_CHARACTERS = 1024;
+var RUNTIME_IGNORE_CONTENT = "*\n";
+var SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+var PERCENTAGE_MAXIMUM = 100;
+var contextReadingSchema = external_exports.strictObject({
+  v: external_exports.literal(1),
+  at: external_exports.string().check(external_exports.minLength(1)),
+  windowTokens: external_exports.nullable(external_exports.int().check(external_exports.positive())),
+  inputTokens: external_exports.nullable(external_exports.int().check(external_exports.nonnegative())),
+  usedPercentage: external_exports.nullable(external_exports.number().check(external_exports.gte(0), external_exports.lte(PERCENTAGE_MAXIMUM)))
+});
+function isReadingSessionId(value) {
+  return value !== void 0 && SESSION_ID_PATTERN.test(value);
+}
+function contextReadingRelativePath(harness, sessionId) {
+  return `${CONTEXT_READINGS_RELATIVE_DIR}/${harness}/${sessionId}.json`;
+}
+
 // src/infrastructure/storage/runtime-state-files.ts
 import { readdir } from "node:fs/promises";
 import { join, relative, resolve as resolve2 } from "node:path";
@@ -18694,7 +18751,7 @@ async function listRuntimeStateFiles(root, readdirFn = readdir) {
 }
 
 // src/infrastructure/runtime/runtime-paths.ts
-var RUNTIME_GITIGNORE_CONTENT = "*\n";
+var RUNTIME_GITIGNORE_CONTENT = RUNTIME_IGNORE_CONTENT;
 var SESSIONS_DIR_NAME = "sessions";
 var LEDGER_FILE_EXTENSION = ".jsonl";
 var SESSIONS_RELATIVE_PREFIX = `${RUNTIME_STATE_RELATIVE_DIR}/${SESSIONS_DIR_NAME}/`;
@@ -19035,7 +19092,7 @@ var defaultProcessHookContext = {
   sessionStartDeadlineMilliseconds: SESSION_START_DEADLINE_MILLISECONDS
 };
 function readStdinUpTo(stream, maximumBytes) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const chunks = [];
     let size = 0;
     stream.on("data", (chunk) => {
@@ -19044,7 +19101,7 @@ function readStdinUpTo(stream, maximumBytes) {
       chunks.push(remaining >= chunk.length ? chunk : chunk.subarray(0, remaining));
       size += chunk.length;
     });
-    stream.on("end", () => resolve6(Buffer.concat(chunks).toString("utf8")));
+    stream.on("end", () => resolve7(Buffer.concat(chunks).toString("utf8")));
     stream.on("error", (error62) => reject(error62));
   });
 }
@@ -19100,10 +19157,49 @@ function parsePayload2(raw) {
 var CLAUDE_CAPABILITIES = [
   { id: "post_tool_telemetry", state: "supported" },
   { id: "session_boot", state: "supported" },
-  { id: "context_usage", state: "unknown", impact: "Read from the session transcript, whose format is undocumented; falls back to an estimate. The context window comes from the status line bridge, which init installs by default; without it, the window falls back to contextWindowCeiling." },
+  { id: "context_usage", state: "unknown", impact: "Read from the session transcript, whose format is undocumented; falls back to an estimate. The context window comes from the mod that init installs on Claude Code 2.1.287 or later, or from the status line bridge on older versions; without either, it falls back to contextWindowCeiling." },
   { id: "auto_restart", state: "unknown", impact: "Opt-in through init --auto-restart; needs Claude Code 2.1.287 or later with mods enabled. Run doctor to check that the mod loads." }
 ];
 
+// src/infrastructure/harnesses/claude-code/mod-reading.ts
+import { readFile as readFile3 } from "node:fs/promises";
+import { resolve as resolve6 } from "node:path";
+
+// src/infrastructure/harnesses/claude-code/project-root.ts
+var PROJECT_DIRECTORY_VARIABLE = "CLAUDE_PROJECT_DIR";
+async function resolveClaudeProjectRoot() {
+  return projectRootFromEnvironment([PROJECT_DIRECTORY_VARIABLE]) ?? await assetProjectRoot();
+}
+
+// src/infrastructure/harnesses/claude-code/mod-reading.ts
+function parseContextReading(text) {
+  if (text.length > CONTEXT_READING_MAXIMUM_CHARACTERS) return null;
+  try {
+    const parsed = contextReadingSchema.safeParse(JSON.parse(text));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+async function readContextReading(sessionId) {
+  if (!isReadingSessionId(sessionId)) return null;
+  const path = resolve6(await resolveClaudeProjectRoot(), contextReadingRelativePath("claude-code", sessionId));
+  return parseContextReading(await readFile3(path, "utf8").catch(() => ""));
+}
+function isNotOlder(reading, transcript) {
+  return transcript === null || Date.parse(reading.at) >= Date.parse(transcript.at);
+}
+function chooseTokens(transcript, reading) {
+  if (reading !== null && reading.inputTokens !== null && isNotOlder(reading, transcript)) return { tokens: reading.inputTokens, at: reading.at };
+  if (transcript === null) return { tokens: null, at: reading?.at };
+  return { tokens: transcript.tokens, at: transcript.at };
+}
+function freshestMeasured(transcript, reading) {
+  if (transcript === null && reading === null) return void 0;
+  const choice = chooseTokens(transcript, reading);
+  return { tokens: choice.tokens, contextWindow: reading?.windowTokens ?? null, at: choice.at };
+}
+
 // src/infrastructure/harnesses/claude-code/schemas.ts
 var claudeHookItemSchema = external_exports.looseObject({
   type: external_exports.optional(external_exports.string()),
@@ -19232,7 +19328,7 @@ var HARNESS = "claude-code";
 var ESTIMATION = { baselineTokens: 15e3, tokensPerTurn: 150 };
 var WRITE_TOOLS = ["Write", "Edit", "MultiEdit", "NotebookEdit"];
 var SKILL_TOOL = "Skill";
-var claudeDescriptor = { harness: HARNESS, capabilities: CLAUDE_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: "/clear" };
+var claudeDescriptor = { harness: HARNESS, capabilities: CLAUDE_CAPABILITIES, estimation: ESTIMATION, newSessionCommand: "/clear", skillInvocation: CLAUDE_SKILL_INVOCATION };
 function sessionOf(payload) {
   return { harness: HARNESS, sessionId: requireIdentifier(payload.session_id), agentId: payload.agent_id ?? null };
 }
@@ -19269,17 +19365,19 @@ function mapClaudeEvent(eventName, payload) {
 async function mapClaudeInput(eventName, payload, errors) {
   if (eventName !== "PostToolUse") return {};
   const data = parsePayload(claudePayloadSchema, payload);
-  const measured = data.agent_id === void 0 ? await measuredUsage({ path: data.transcript_path, eventName, errors }) : void 0;
+  const measured = data.agent_id === void 0 ? await measuredUsage({ path: data.transcript_path, sessionId: data.session_id, eventName, errors }) : void 0;
   const usage = measured === void 0 ? {} : { measured };
   return { ...usage, observedCharacters: characterLength(data.tool_input) + characterLength(data.tool_response) };
 }
 async function measuredUsage(input2) {
+  return freshestMeasured(await transcriptUsage(input2), await readContextReading(input2.sessionId));
+}
+async function transcriptUsage(input2) {
   try {
-    const usage = await readTranscriptUsage(input2.path);
-    return usage === null ? void 0 : { tokens: usage.tokens, contextWindow: null, at: usage.at };
+    return await readTranscriptUsage(input2.path);
   } catch (error62) {
     await recordRuntimeFailure(input2.errors, { harness: HARNESS, event: input2.eventName, code: "UNEXPECTED", detail: failureDetail(error62) });
-    return void 0;
+    return null;
   }
 }
 function renderClaudeDecision(decision, eventName) {
@@ -19292,7 +19390,7 @@ var claudeAdapter = {
   mapEvent: mapClaudeEvent,
   mapInput: mapClaudeInput,
   renderDecision: renderClaudeDecision,
-  resolveProjectRoot: async () => projectRootFromEnvironment(["CLAUDE_PROJECT_DIR"]) ?? await assetProjectRoot()
+  resolveProjectRoot: resolveClaudeProjectRoot
 };
 function runClaudeCodeHook() {
   return runProcessHook(claudeAdapter);

package/dist/assets/runtime/claude-code-mod.mjs

@@ -18136,6 +18136,26 @@ function date4(params) {
   return _coercedDate(ZodMiniDate, params);
 }
 
+// src/core/contracts/context-reading.ts
+var CONTEXT_READINGS_RELATIVE_DIR = ".context-brake/runtime/context-readings";
+var RUNTIME_IGNORE_RELATIVE_PATH = ".context-brake/runtime/.gitignore";
+var RUNTIME_IGNORE_CONTENT = "*\n";
+var SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+var PERCENTAGE_MAXIMUM = 100;
+var contextReadingSchema = external_exports.strictObject({
+  v: external_exports.literal(1),
+  at: external_exports.string().check(external_exports.minLength(1)),
+  windowTokens: external_exports.nullable(external_exports.int().check(external_exports.positive())),
+  inputTokens: external_exports.nullable(external_exports.int().check(external_exports.nonnegative())),
+  usedPercentage: external_exports.nullable(external_exports.number().check(external_exports.gte(0), external_exports.lte(PERCENTAGE_MAXIMUM)))
+});
+function isReadingSessionId(value) {
+  return value !== void 0 && SESSION_ID_PATTERN.test(value);
+}
+function contextReadingRelativePath(harness, sessionId) {
+  return `${CONTEXT_READINGS_RELATIVE_DIR}/${harness}/${sessionId}.json`;
+}
+
 // src/core/contracts/auto-restart.ts
 var DEFAULT_MAX_CONSECUTIVE_RESTARTS = 2;
 var MIN_CONSECUTIVE_RESTARTS = 1;
@@ -18180,56 +18200,6 @@ var restartLogSchema = external_exports.strictObject({
   records: external_exports.array(restartLogRecordSchema).check(external_exports.maxLength(RESTART_LOG_MAX_RECORDS))
 });
 
-// src/infrastructure/harnesses/claude-code/mod/mod-info.ts
-var MOD_VERSION = "1.0.0";
-var MOD_LOG_DIR = `${RESTART_LOG_RELATIVE_DIR}/claude-code`;
-var CONFIG_FILE = "context-brake.config.json";
-var PERSON_PROMPT_ORIGINS = ["composer", "bridge"];
-
-// src/core/contracts/restart-host.ts
-var guardStateSchema = external_exports.strictObject({ consecutive: external_exports.int().check(external_exports.minimum(0)), toolCallsSinceSeed: external_exports.nullable(external_exports.int().check(external_exports.minimum(0))) });
-var IDLE_GUARD_STATE = { consecutive: 0, toolCallsSinceSeed: null };
-
-// src/core/services/restart-guards.ts
-async function bumpConsecutive(store) {
-  const state = await store.read();
-  await store.write({ ...state, consecutive: state.consecutive + 1 });
-}
-async function rollbackConsecutive(store) {
-  const state = await store.read();
-  await store.write({ ...state, consecutive: Math.max(0, state.consecutive - 1) });
-}
-async function markSeeded(store) {
-  const state = await store.read();
-  await store.write({ ...state, toolCallsSinceSeed: 0 });
-}
-async function foldToolCalls(store, calls) {
-  const state = await store.read();
-  if (state.toolCallsSinceSeed === null || calls === 0) return;
-  await store.write({ ...state, toolCallsSinceSeed: state.toolCallsSinceSeed + calls });
-}
-async function resetConsecutive(store) {
-  const state = await store.read();
-  if (state.consecutive === 0 && state.toolCallsSinceSeed === null) return;
-  await store.write(IDLE_GUARD_STATE);
-}
-
-// src/infrastructure/harnesses/claude-code/mod/mod-guards.ts
-function guardKey(root) {
-  return `contextbrake:autorestart:${root}`;
-}
-function modGuardStore($, root) {
-  return {
-    read: async () => {
-      const parsed = guardStateSchema.safeParse(await $.store.get(guardKey(root)));
-      return parsed.success ? parsed.data : IDLE_GUARD_STATE;
-    },
-    write: async (state) => {
-      await $.store.set(guardKey(root), state);
-    }
-  };
-}
-
 // src/core/services/auto-restart-notices.ts
 var SEED_BASE = "ContextBrake: this session was restarted automatically. Continue the previous work from the state it recorded.";
 var SKIPPED = "ContextBrake: automatic restart skipped: ";
@@ -18260,6 +18230,12 @@ function appendLogRecord(records, record2) {
   return [...records, record2].slice(-RESTART_LOG_MAX_RECORDS);
 }
 
+// src/infrastructure/harnesses/claude-code/mod/mod-info.ts
+var MOD_VERSION = "1.1.0";
+var MOD_LOG_DIR = `${RESTART_LOG_RELATIVE_DIR}/claude-code`;
+var CONFIG_FILE = "context-brake.config.json";
+var PERSON_PROMPT_ORIGINS = ["composer", "bridge"];
+
 // src/infrastructure/harnesses/claude-code/mod/mod-log.ts
 async function logPath($) {
   return `${await $.session.root()}/${MOD_LOG_DIR}/${await $.session.id()}.json`;
@@ -18280,6 +18256,9 @@ async function writeLog($, path, log) {
   await $.fs.write(path, `${JSON.stringify(log, null, 2)}
 `);
 }
+async function lastRecordedCode($) {
+  return (await readLog($, await logPath($))).records.at(-1)?.code;
+}
 async function recordLoaded($) {
   const path = await logPath($);
   const log = await readLog($, path);
@@ -18298,6 +18277,34 @@ function endsWithResetSignal(text) {
   return text.trimEnd().split(/\r?\n/).at(-1)?.endsWith(SESSION_RESET_SIGNAL) ?? false;
 }
 
+// src/core/contracts/restart-host.ts
+var guardStateSchema = external_exports.strictObject({ consecutive: external_exports.int().check(external_exports.minimum(0)), toolCallsSinceSeed: external_exports.nullable(external_exports.int().check(external_exports.minimum(0))) });
+var IDLE_GUARD_STATE = { consecutive: 0, toolCallsSinceSeed: null };
+
+// src/core/services/restart-guards.ts
+async function bumpConsecutive(store) {
+  const state = await store.read();
+  await store.write({ ...state, consecutive: state.consecutive + 1 });
+}
+async function rollbackConsecutive(store) {
+  const state = await store.read();
+  await store.write({ ...state, consecutive: Math.max(0, state.consecutive - 1) });
+}
+async function markSeeded(store) {
+  const state = await store.read();
+  await store.write({ ...state, toolCallsSinceSeed: 0 });
+}
+async function foldToolCalls(store, calls) {
+  const state = await store.read();
+  if (state.toolCallsSinceSeed === null || calls === 0) return;
+  await store.write({ ...state, toolCallsSinceSeed: state.toolCallsSinceSeed + calls });
+}
+async function resetConsecutive(store) {
+  const state = await store.read();
+  if (state.consecutive === 0 && state.toolCallsSinceSeed === null) return;
+  await store.write(IDLE_GUARD_STATE);
+}
+
 // src/core/services/auto-restart-policy.ts
 function standDownCode(facts) {
   if (facts.disabledByEnv) return "SKIP_DISABLED_ENV";
@@ -18361,6 +18368,34 @@ async function handleTurnEnd(host, turn) {
   });
 }
 
+// src/core/contracts/skill-name.ts
+var MAX_SKILL_NAME_LENGTH = 64;
+var NAME_SEGMENT = "[a-z0-9]+(?:-[a-z0-9]+)*";
+var NAMESPACE_SEPARATOR = ":";
+var INVOCATION_CHARACTERS = ["/", "$", "@"];
+var MAX_QUALIFIED_LENGTH = MAX_SKILL_NAME_LENGTH * 2 + NAMESPACE_SEPARATOR.length;
+function segmentFits(end) {
+  return `(?=[^${NAMESPACE_SEPARATOR}]{1,${MAX_SKILL_NAME_LENGTH}}${end})`;
+}
+var PREFIX = `(?:${segmentFits(NAMESPACE_SEPARATOR)}${NAME_SEGMENT}${NAMESPACE_SEPARATOR})?`;
+var SKILL_NAME_PATTERN = new RegExp(`^${PREFIX}${segmentFits("$")}${NAME_SEGMENT}$`);
+var SHAPE_RULE = `lowercase letters, digits, and single hyphens, up to ${MAX_SKILL_NAME_LENGTH} characters, optionally prefixed by a plugin name and a colon`;
+function isSkillName(value) {
+  return SKILL_NAME_PATTERN.test(value);
+}
+function skillNameProblem(value) {
+  if (value === "") return "must not be empty";
+  if (isSkillName(value)) return null;
+  const bare = INVOCATION_CHARACTERS.includes(value.charAt(0)) ? value.slice(1) : null;
+  if (bare !== null && isSkillName(bare)) return `"${value}" is not a skill name; use the bare name ${bare}`;
+  return `"${value}" is not a skill name; use ${SHAPE_RULE}`;
+}
+var skillNameSchema = external_exports.string().check((ctx) => {
+  const message = skillNameProblem(ctx.value);
+  if (message !== null) ctx.issues.push({ code: "custom", input: ctx.value, message });
+});
+external_exports.globalRegistry.add(skillNameSchema, { pattern: SKILL_NAME_PATTERN.source, maxLength: MAX_QUALIFIED_LENGTH });
+
 // src/core/contracts/zones.ts
 var SNAPSHOT_TRIGGER_ZONES = ["YELLOW", "RED"];
 
@@ -18381,15 +18416,8 @@ function uniqueCheck(message) {
     if (!isUnique(ctx.value)) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message });
   };
 }
-var MAX_AGENT_COMMAND_LENGTH = 200;
-var TRIMMED_RULE = "must not have leading or trailing whitespace";
 var RESUME_REQUIRES_COMMAND_RULE = "requires snapshot.command";
-var SINGLE_LINE_RULE = "must be a single line";
-var agentCommand = external_exports.string().check(external_exports.minLength(1), external_exports.maxLength(MAX_AGENT_COMMAND_LENGTH), (ctx) => {
-  if (ctx.value.trim() !== ctx.value) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message: TRIMMED_RULE });
-  if (/[\r\n]/.test(ctx.value)) addIssue(ctx, { code: "custom", path: [], input: ctx.value, message: SINGLE_LINE_RULE });
-});
-var snapshotSchema = external_exports.strictObject({ triggerZone: external_exports._default(external_exports.enum(SNAPSHOT_TRIGGER_ZONES), "RED"), command: external_exports.optional(agentCommand), resumeCommand: external_exports.optional(agentCommand) }).check((ctx) => {
+var snapshotSchema = external_exports.strictObject({ triggerZone: external_exports._default(external_exports.enum(SNAPSHOT_TRIGGER_ZONES), "RED"), triggerPercentage: external_exports.optional(external_exports.int().check(external_exports.minimum(1), external_exports.maximum(100))), command: external_exports.optional(skillNameSchema), resumeCommand: external_exports.optional(skillNameSchema) }).check((ctx) => {
   if (ctx.value.resumeCommand !== void 0 && ctx.value.command === void 0) addIssue(ctx, { code: "custom", path: ["resumeCommand"], input: ctx.value.resumeCommand, message: RESUME_REQUIRES_COMMAND_RULE });
 });
 var DEFAULT_SNAPSHOT = { triggerZone: "RED" };
@@ -18442,6 +18470,22 @@ async function readModConfig($) {
   };
 }
 
+// src/infrastructure/harnesses/claude-code/mod/mod-guards.ts
+function guardKey(root) {
+  return `contextbrake:autorestart:${root}`;
+}
+function modGuardStore($, root) {
+  return {
+    read: async () => {
+      const parsed = guardStateSchema.safeParse(await $.store.get(guardKey(root)));
+      return parsed.success ? parsed.data : IDLE_GUARD_STATE;
+    },
+    write: async (state) => {
+      await $.store.set(guardKey(root), state);
+    }
+  };
+}
+
 // src/core/contracts/handoff.ts
 var HANDOFF_RELATIVE_PATH = ".context-brake/handoff.md";
 
@@ -18517,6 +18561,64 @@ async function handleTurnComplete($, event) {
   await handleTurnEnd(createModRestartHost($, config2), { text, settings: { maxConsecutive: config2.maxConsecutive, mode: config2.mode } });
 }
 
+// src/infrastructure/harnesses/claude-code/mod/context-reading.ts
+var READING_HARNESS = "claude-code";
+var READING_VERSION = 1;
+var PERCENTAGE_MAXIMUM2 = 100;
+var UNREADABLE_CODE = "ERROR_INTERNAL";
+function positiveIntegerOrNull(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+}
+function countOrNull(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function percentageOrNull(value) {
+  return typeof value === "number" && value >= 0 && value <= PERCENTAGE_MAXIMUM2 ? value : null;
+}
+function readingOf(context, at) {
+  return { v: READING_VERSION, at, windowTokens: positiveIntegerOrNull(context.window), inputTokens: countOrNull(context.tokens), usedPercentage: percentageOrNull(context.percent) };
+}
+async function isAlreadyPublished($, path, reading) {
+  if (!await $.fs.exists(path)) return false;
+  try {
+    const previous = contextReadingSchema.safeParse(JSON.parse(String(await $.fs.read(path))));
+    return previous.success && previous.data.windowTokens === reading.windowTokens && previous.data.inputTokens === reading.inputTokens;
+  } catch {
+    return false;
+  }
+}
+async function ensureRuntimeIgnore($, root) {
+  const path = `${root}/${RUNTIME_IGNORE_RELATIVE_PATH}`;
+  if (!await $.fs.exists(path)) await $.fs.write(path, RUNTIME_IGNORE_CONTENT);
+}
+async function reportOnce($) {
+  try {
+    if (await lastRecordedCode($) === UNREADABLE_CODE) return;
+  } catch {
+    return;
+  }
+  await reportSafely($, UNREADABLE_CODE);
+}
+async function publishChanged($) {
+  const sessionId = await $.session.id();
+  if (!isReadingSessionId(sessionId)) return;
+  const reading = readingOf((await $.session.usage()).context, new Date(await $.clock.now()).toISOString());
+  if (reading.windowTokens === null) return reportOnce($);
+  const root = await $.session.root();
+  const path = `${root}/${contextReadingRelativePath(READING_HARNESS, sessionId)}`;
+  if (await isAlreadyPublished($, path, reading)) return;
+  await ensureRuntimeIgnore($, root);
+  await $.fs.write(path, `${JSON.stringify(reading)}
+`);
+}
+async function publishContextReading($) {
+  try {
+    await publishChanged($);
+  } catch {
+    await reportOnce($);
+  }
+}
+
 // src/infrastructure/harnesses/claude-code/mod/hooks.ts
 async function onSessionStart($) {
   try {
@@ -18555,17 +18657,21 @@ async function onPromptSubmit($, event) {
 function register(on) {
   on("session.start", async ($, e, next) => {
     await onSessionStart($);
+    await publishContextReading($);
     return next(e);
   });
   on("turn.start", async ($, e, next) => {
     await onTurnStart($);
+    await publishContextReading($);
     return next(e);
   });
-  on("tool.call", async (_$, e, next) => {
+  on("tool.call", async ($, e, next) => {
     onToolCall();
+    await publishContextReading($);
     return next(e);
   });
   on("turn.complete", async ($, e, next) => {
+    await publishContextReading($);
     await onTurnComplete($, e);
     return next(e);
   });