context-brake 1.0.0 → 1.1.0

package/dist/src/infrastructure/storage/change-applier.d.ts

@@ -1,5 +1,6 @@
 import type { ApplyReport, ChangeApplier, ChangePlan } from '../../core/contracts/changes.js';
 export declare const FILE_CHANGED_CODE: "FILE_CHANGED_SINCE_PREVIEW";
+export declare const FILE_UNREADABLE_CODE: "FILE_UNREADABLE";
 export type ChangeApplierOptions = {
     pruneRuntime?: boolean | undefined;
 };

package/dist/src/infrastructure/storage/change-applier.js

@@ -3,6 +3,7 @@ import { deleteFileIfExists, writeFileAtomically } from './atomic-writer.js';
 import { pruneEmptyContextBrakeDirectories } from './directory-pruner.js';
 import { computeSha256 } from './node-file-system.js';
 export const FILE_CHANGED_CODE = 'FILE_CHANGED_SINCE_PREVIEW';
+export const FILE_UNREADABLE_CODE = 'FILE_UNREADABLE';
 async function checkPrecondition(change) {
     try {
         const current = await readFile(change.realPath, 'utf8');
@@ -22,7 +23,7 @@ async function checkPrecondition(change) {
             }
             return null;
         }
-        throw err;
+        return `${FILE_UNREADABLE_CODE}: ${err.message}`;
     }
 }
 async function applySingleChange(change) {

package/dist/src/infrastructure/storage/json-document-editor.js

@@ -1,6 +1,7 @@
 import { findNodeAtLocation, getNodeValue } from 'jsonc-parser';
 import { parseAndValidateJson } from './json-validator.js';
-import { detectEol, detectIndent, formatJsonValue, insertArrayItem, insertObjectEntry, removeNodeSpan } from './json-span-utils.js';
+import { detectEol, detectIndent, formatJsonValue, insertArrayItem, insertObjectEntry } from './json-span-utils.js';
+import { removeNodeSpan } from './json-node-removal.js';
 export { InvalidJsonDocumentError, validateJsonDocument, parseAndValidateJson } from './json-validator.js';
 export function setJsonProperty(text, path, value) {
     const root = parseAndValidateJson(text);

package/dist/src/infrastructure/storage/json-node-removal.d.ts

@@ -0,0 +1,2 @@
+import type { Node } from 'jsonc-parser';
+export declare function removeNodeSpan(text: string, node: Node): string;

package/dist/src/infrastructure/storage/json-node-removal.js

@@ -0,0 +1,70 @@
+import { findLineEndAfter, findSeparatorComma } from './json-span-utils.js';
+function siblingContext(node) {
+    const list = node.parent?.children;
+    return list ? { list, index: list.indexOf(node) } : undefined;
+}
+function commaAfterPrevious(text, node) {
+    const context = siblingContext(node);
+    if (!context || context.index <= 0)
+        return -1;
+    const previous = context.list[context.index - 1];
+    return findSeparatorComma(text, previous.offset + previous.length, node.offset);
+}
+function commaBeforeNext(text, node) {
+    const context = siblingContext(node);
+    const next = context?.list[context.index + 1];
+    return next ? findSeparatorComma(text, node.offset + node.length, next.offset) : -1;
+}
+function isLastChild(node) {
+    const context = siblingContext(node);
+    return context === undefined || context.index === context.list.length - 1;
+}
+function isOnlyNodeOnLine(text, span) {
+    const leading = text.slice(span.lineStart, span.start);
+    return /^\s*$/.test(leading) && /^[ \t]*,?[ \t]*\r?\n?$/.test(text.slice(span.end, span.lineEnd));
+}
+function removeLastNode(text, node, span) {
+    const ownLine = isOnlyNodeOnLine(text, span);
+    const after = text.slice(ownLine ? span.lineEnd : span.end);
+    const comma = !ownLine || isLastChild(node) ? commaAfterPrevious(text, node) : -1;
+    const cut = ownLine ? span.lineStart : span.start;
+    if (comma === -1)
+        return `${text.slice(0, cut)}${after}`;
+    return `${text.slice(0, comma)}${text.slice(comma + 1, cut)}${after}`;
+}
+function removeBeforeComma(text, node, span) {
+    const before = text.slice(0, span.start);
+    const leadingComma = before.match(/,\s*$/);
+    if (leadingComma?.index !== undefined)
+        return `${before.slice(0, leadingComma.index)}${text.slice(span.end)}`;
+    const comma = commaBeforeNext(text, node);
+    if (comma === -1)
+        return `${before}${text.slice(span.end)}`;
+    return `${before}${text.slice(span.end, comma)}${text.slice(comma + 1)}`;
+}
+function emptyContainer(text, node) {
+    const container = node.parent;
+    if (container?.children?.length !== 1)
+        return undefined;
+    const open = container.offset + 1;
+    const close = container.offset + container.length - 1;
+    const rest = `${text.slice(open, node.offset)}${text.slice(node.offset + node.length, close)}`;
+    return /^\s*$/.test(rest) ? `${text.slice(0, open)}${text.slice(close)}` : undefined;
+}
+export function removeNodeSpan(text, node) {
+    const emptied = emptyContainer(text, node);
+    if (emptied !== undefined)
+        return emptied;
+    const start = node.offset;
+    const end = start + node.length;
+    const lineStart = text.lastIndexOf('\n', start) + 1;
+    const span = { start, end, lineStart, lineEnd: findLineEndAfter(text, end) };
+    if (isOnlyNodeOnLine(text, span))
+        return removeLastNode(text, node, span);
+    const trailingComma = text.slice(end).match(/^\s*,/);
+    if (trailingComma)
+        return `${text.slice(0, start)}${text.slice(end + trailingComma[0].length)}`;
+    if (isLastChild(node))
+        return removeLastNode(text, node, span);
+    return removeBeforeComma(text, node, span);
+}

package/dist/src/infrastructure/storage/json-span-utils.d.ts

@@ -19,6 +19,6 @@ export declare function detectEol(text: string): string;
 export declare function detectIndent(text: string): string;
 export declare function findLineEndAfter(text: string, offset: number): number;
 export declare function formatJsonValue(value: unknown, opts: FormatOptions): string;
+export declare function findSeparatorComma(text: string, from: number, to: number): number;
 export declare function insertObjectEntry(text: string, parentNode: Node, opts: InsertEntryOptions): string;
 export declare function insertArrayItem(text: string, arrayNode: Node, opts: InsertItemOptions): string;
-export declare function removeNodeSpan(text: string, node: Node): string;

package/dist/src/infrastructure/storage/json-span-utils.js

@@ -16,7 +16,7 @@ export function formatJsonValue(value, opts) {
     const prefix = opts.indent.repeat(opts.depth);
     return raw.split('\n').map((line, idx) => (idx === 0 ? line : `${prefix}${line}`)).join(opts.eol);
 }
-function findSeparatorComma(text, from, to) {
+export function findSeparatorComma(text, from, to) {
     let index = from;
     while (index < to) {
         if (text.startsWith('//', index))
@@ -55,50 +55,3 @@ export function insertObjectEntry(text, parentNode, opts) {
 export function insertArrayItem(text, arrayNode, opts) {
     return insertIntoContainer(text, arrayNode, { item: opts.formattedVal, indent: opts.indent, depth: opts.depth });
 }
-function siblingContext(node) {
-    const list = node.parent?.children;
-    return list ? { list, index: list.indexOf(node) } : undefined;
-}
-function commaAfterPrevious(text, node) {
-    const context = siblingContext(node);
-    if (!context || context.index <= 0)
-        return -1;
-    const previous = context.list[context.index - 1];
-    return findSeparatorComma(text, previous.offset + previous.length, node.offset);
-}
-function isLastChild(node) {
-    const context = siblingContext(node);
-    return context === undefined || context.index === context.list.length - 1;
-}
-function isOnlyNodeOnLine(text, span) {
-    const leading = text.slice(span.lineStart, span.start);
-    return /^\s*$/.test(leading) && /^[ \t]*,?[ \t]*\r?\n?$/.test(text.slice(span.end, span.lineEnd));
-}
-function removeLastNode(text, node, span) {
-    const ownLine = isOnlyNodeOnLine(text, span);
-    const after = text.slice(ownLine ? span.lineEnd : span.end);
-    const comma = !ownLine || /^\s*[\]}]/.test(after) ? commaAfterPrevious(text, node) : -1;
-    const cut = ownLine ? span.lineStart : span.start;
-    if (comma === -1)
-        return `${text.slice(0, cut)}${after}`;
-    return `${text.slice(0, comma)}${text.slice(comma + 1, cut)}${after}`;
-}
-export function removeNodeSpan(text, node) {
-    const start = node.offset;
-    const end = start + node.length;
-    const lineStart = text.lastIndexOf('\n', start) + 1;
-    const span = { start, end, lineStart, lineEnd: findLineEndAfter(text, end) };
-    if (isOnlyNodeOnLine(text, span))
-        return removeLastNode(text, node, span);
-    const after = text.slice(end);
-    const trailingComma = after.match(/^\s*,/);
-    if (trailingComma)
-        return `${text.slice(0, start)}${after.slice(trailingComma[0].length)}`;
-    if (isLastChild(node))
-        return removeLastNode(text, node, span);
-    const before = text.slice(0, start);
-    const leadingComma = before.match(/,\s*$/);
-    if (leadingComma?.index !== undefined)
-        return `${before.slice(0, leadingComma.index)}${after}`;
-    return `${before}${after}`;
-}

package/docs/telemetry-block.md

@@ -44,6 +44,8 @@ With `snapshot.command` set, from `snapshot.triggerZone` (`RED` by default, or `
 | `YELLOW` or `RED` at or above the trigger | `run "<command>", then end reply with [REQUEST_SESSION_RESET]` |
 | `CRITICAL` | `run "<command>" now, then end reply with [REQUEST_SESSION_RESET]` |
 
+When `snapshot.triggerPercentage` is set, it replaces the zone rule: the same actions start once the usage reaches that percentage in any zone, `GREEN` included, and the block is injected from there even below the activation threshold.
+
 ContextBrake never runs the command; it only passes the text to the agent, so the command can be a skill, a slash command, or a short instruction. The longest block, with any action variant and a typical command, stays within 60 tokens.
 
 ### Versioning Rule
@@ -88,7 +90,7 @@ With turn limits of `greenMaxTurn: 59` and `yellowMaxTurn: 99`, the turn shows w
 ```
 
 ### 🔴 `RED` Zone
-The session is in danger of context exhaustion. With `snapshot.command` set to `/sdd-snapshot`, the agent saves its state and requests a session reset; without it, the agent wraps up and reports what remains:
+The session is in danger of context exhaustion. With `snapshot.command` set to `sdd-snapshot` (written `/sdd-snapshot` for Claude Code), the agent saves its state and requests a session reset; without it, the agent wraps up and reports what remains:
 
 ```text
 [ContextBrake v3] turn=11 usage=68% tokens=87040/128000 source=estimated window=config zone=RED action=run "/sdd-snapshot", then end reply with [REQUEST_SESSION_RESET]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-brake",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Context telemetry and an advisory brake for coding-agent harnesses",
   "license": "MIT",
   "repository": {

package/schemas/context-brake.config.schema.json

@@ -136,15 +136,20 @@
             "RED"
           ]
         },
+        "triggerPercentage": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
         "command": {
           "type": "string",
-          "minLength": 1,
-          "maxLength": 200
+          "pattern": "^(?:(?=[^:]{1,64}:)[a-z0-9]+(?:-[a-z0-9]+)*:)?(?=[^:]{1,64}$)[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 129
         },
         "resumeCommand": {
           "type": "string",
-          "minLength": 1,
-          "maxLength": 200
+          "pattern": "^(?:(?=[^:]{1,64}:)[a-z0-9]+(?:-[a-z0-9]+)*:)?(?=[^:]{1,64}$)[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "maxLength": 129
         }
       },
       "additionalProperties": false

package/schemas/doctor-report.schema.json

@@ -427,6 +427,11 @@
             "RED"
           ]
         },
+        "triggerPercentage": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
         "command": {
           "type": [
             "string",
@@ -438,6 +443,42 @@
             "string",
             "null"
           ]
+        },
+        "invocations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "harness": {
+                "type": "string",
+                "enum": [
+                  "claude-code",
+                  "codex-cli",
+                  "cursor",
+                  "github-copilot-cli",
+                  "opencode",
+                  "pi",
+                  "oh-my-pi",
+                  "antigravity-cli"
+                ]
+              },
+              "command": {
+                "type": "string"
+              },
+              "resumeCommand": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "harness",
+              "command",
+              "resumeCommand"
+            ],
+            "additionalProperties": false
+          }
         }
       },
       "required": [
@@ -458,9 +499,18 @@
             "inactive"
           ]
         },
+        "mod": {
+          "type": "string",
+          "enum": [
+            "absent",
+            "installed",
+            "reporting"
+          ]
+        },
         "source": {
           "type": "string",
           "enum": [
+            "mod",
             "statusline",
             "contextWindowCeiling"
           ]
@@ -480,6 +530,7 @@
       },
       "required": [
         "bridge",
+        "mod",
         "source",
         "lastWindowTokens"
       ],