context-guard

{
  "name": "context-guard",
  "version": "1.0.2",
  "description": "Per-session context-window observability. A mod writes each session's context-window figures to a snapshot file and shows the person a toast and a transcript line when the context zone (smart, acceptable or dumb, from bands in zones.json) worsens; with model_notices on (off by default) it also tells Claude the zone at each crossing, approach and compaction. /context-guard prints status and toggles an optional band row. It answers a status tool. A PostCompact hook leaves a marker.",
  "author": {
    "name": "Melodic Software",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": [
    "context-window",
    "mod",
    "zones",
    "context-degradation",
    "session",
    "hooks"
  ],
  "userConfig": {
    "context_guard_hooks_enabled": {
      "type": "boolean",
      "title": "Zone notices and compaction marker",
      "description": "Runs the module's zone lines and toasts and the PostCompact marker hook. On by default; off, none of them acts. Snapshot writes continue either way.",
      "default": true
    },
    "model_notices": {
      "type": "boolean",
      "title": "Model notices",
      "description": "Sends Claude one line when the session crosses into a worse context zone, approaches a boundary, or passes a zones.json threshold, and restates the zone after a compaction, a resume or a reload. Off by default; the toast, transcript line, band row, status tool and snapshot work either way.",
      "default": false
    },
    "zone_report_mode": {
      "type": "string",
      "title": "Zone report mode",
      "description": "Acts only with model_notices on. automatic (default) sends the lines to Claude; operator holds them in a turn a person typed and offers the person a ready-made prompt and a notice row when the turn ends. Headless, loop and schedule turns get automatic lines either way.",
      "default": "automatic",
      "options": [
        "automatic",