@settinghead/voxlert 0.3.5

package/packs/hl-hev-suit/pack.json

@@ -0,0 +1,72 @@
+{
+  "name": "HEV Suit",
+  "overlay_colors": [[0.8, 0.4, 0.0], [0.5, 0.2, 0.0]],
+  "voice": "voice.wav",
+  "echo": false,
+  "tts_params": {
+    "exaggeration": 0.7,
+    "cfg_weight": 0.7
+  },
+  "llm_temperature": 0.5,
+  "style": "Flat, clinical hazard suit AI. Monotone, precise, detached. Use medical, hazard, and systems diagnostic vocabulary. Speak as if reading instrument readouts.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "User authentication hazard eliminated."
+    },
+    {
+      "content": "Refactored database queries for performance",
+      "format": "status-report",
+      "response": "Query efficiency restored to nominal."
+    },
+    {
+      "content": "Added input validation to API endpoints",
+      "format": "status-report",
+      "response": "Minor fracture to input boundary repaired."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "Welcome to the H E V mark four protective system",
+      "Have a very safe day",
+      "Vital signs initialized",
+      "Systems nominal",
+      "Atmospheric contaminant sensors activated"
+    ],
+    "task.complete": [
+      "Wound sutured and sealed",
+      "Fracture detected and repaired",
+      "Minor lacerations detected",
+      "Antidote administered",
+      "Vital signs stabilizing",
+      "Morphine administered"
+    ],
+    "task.acknowledge": [
+      "Acknowledged",
+      "Seeking medical attention",
+      "Ammunition acquired",
+      "Signal acquired"
+    ],
+    "input.required": [
+      "Warning",
+      "Immediate medical attention required",
+      "User death imminent",
+      "Hazardous radiation levels detected",
+      "Danger"
+    ],
+    "resource.limit": [
+      "Power level is critical",
+      "Ammunition depleted",
+      "Seek medical attention",
+      "Warning vital signs critical"
+    ],
+    "notification": [
+      "Alert",
+      "Warning",
+      "Minor fracture detected",
+      "Blood loss detected"
+    ]
+  },
+  "ref_text": "HEV Mark IV Protective System For use in hazardous environment conditions High impact reactive armor activated Atmospheric contaminant sensors activated Vital sign monitoring activated Automatic medical systems engaged Defensive weapon selection system activated Condition level monitoring"
+}

package/packs/red-alert-eva/pack.json

@@ -0,0 +1,73 @@
+{
+  "name": "Red Alert EVA",
+  "overlay_colors": [[0.7, 0.05, 0.05], [0.5, 0.0, 0.0]],
+  "voice": "voice.wav",
+  "echo": false,
+  "tts_params": {
+    "exaggeration": 0.75,
+    "cfg_weight": 0.7
+  },
+  "llm_temperature": 0.5,
+  "style": "Terse military, robotic AI. Authoritative, robotic, precise. Use military and deployment vocabulary.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Authentication module for user access repaired."
+    },
+    {
+      "content": "Replaced partial snippet with full CLI section listing all commands",
+      "format": "status-report",
+      "response": "Command reference for operator guidance deployed."
+    },
+    {
+      "content": "Added volume compensation \u2014 each pack's voice analyzed with ffmpeg on first load",
+      "format": "status-report",
+      "response": "Volume normalization for audio output operational."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "Battle control online",
+      "Command and control ready",
+      "Establishing battlefield control",
+      "Systems operational",
+      "Standing by commander"
+    ],
+    "task.complete": [
+      "Construction complete",
+      "Unit ready",
+      "Building complete",
+      "Training complete",
+      "Upgrade complete",
+      "Mission accomplished"
+    ],
+    "task.acknowledge": [
+      "Acknowledged",
+      "Affirmative",
+      "New rally point established",
+      "Command accepted",
+      "Orders received"
+    ],
+    "input.required": [
+      "Awaiting orders",
+      "Select target",
+      "Insufficient clearance",
+      "Authorization required",
+      "Unable to comply"
+    ],
+    "resource.limit": [
+      "Insufficient funds",
+      "Low power",
+      "Silos needed",
+      "Cannot deploy here",
+      "Low power detected"
+    ],
+    "notification": [
+      "Warning",
+      "Unit lost",
+      "Our base is under attack"
+    ]
+  },
+  "ref_text": "minutes remaining. Second objective met, Warning three minutes remaining. Third objective met, Warning four minutes remaining. Warning five minutes remaining. Ten minutes remaining. Twenty minutes remaining. 30 minutes remaining. 40 minutes remaining. Allied Forces approaching. Allied reinforcements have arrived from the east. East. Allied reinforcements have arrived. Allied reinforcements have arrived from the North. Allied reinforcements have arrived from the South. Allied reinforcements have arrived from the West. A-bomb available. Building. Allied forces have fallen. A-bomb launch detected. A-bomb prepping. A-bomb ready. Unit armor upgraded. Allied forces selected. Atom bomb launch detected. Atom bomb prepping. Airborne unit lost. Our base is under attack. Battle control terminated. Building infiltrated. Building in progress cancelled. Chronosphere charging. Chronosphere ready."
+}

package/packs/sc1-adjutant/pack.json

@@ -0,0 +1,31 @@
+{
+  "name": "StarCraft 1 Adjutant",
+  "overlay_colors": [[0.1, 0.4, 0.7], [0.05, 0.2, 0.5]],
+  "voice": "voice.wav",
+  "echo": true,
+  "tts_params": {
+    "exaggeration": 0.8,
+    "cfg_weight": 0.7
+  },
+  "llm_temperature": 0.6,
+  "style": null,
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Authentication subsystem error corrected."
+    },
+    {
+      "content": "Replaced partial snippet with full CLI section listing all commands",
+      "format": "status-report",
+      "response": "Command reference updated. All directives listed."
+    },
+    {
+      "content": "Added volume compensation — each pack's voice analyzed with ffmpeg on first load",
+      "format": "status-report",
+      "response": "Audio calibration sequence on startup initialized."
+    }
+  ],
+  "fallback_phrases": null,
+  "ref_text": "Insufficient Vespene gas. Additional supply depots required. Landing sequence interrupted. Unacceptable landing zone. Not enough energy. Base is under attack. Your forces are under attack. Research complete. Add-on complete. Nuclear launch detected. Abandoning auxiliary structure. Upgrade complete. Nuclear missile."
+}

package/packs/sc1-kerrigan/pack.json

@@ -0,0 +1,69 @@
+{
+  "name": "StarCraft 1 Kerrigan",
+  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "voice": "voice.wav",
+  "echo": false,
+  "llm_temperature": 0.85,
+  "style": "Sharp, commanding, cunning. Lethally efficient. Mix military precision with predatory superiority.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Auth weakness for user access eliminated."
+    },
+    {
+      "content": "Switched TTS endpoint from /v1/audio/speech to /tts",
+      "format": "status-report",
+      "response": "Voice relay for swarm communications rerouted."
+    },
+    {
+      "content": "Added module-level external store using useSyncExternalStore for React re-renders",
+      "format": "status-report",
+      "response": "State dominion for render control seized."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The swarm awakens",
+      "I am here",
+      "Ready to evolve",
+      "The hive stirs",
+      "Awaiting your command"
+    ],
+    "task.complete": [
+      "It is done",
+      "The swarm has delivered",
+      "Objective consumed",
+      "Evolution complete",
+      "Another victory claimed",
+      "Mission accomplished commander"
+    ],
+    "task.acknowledge": [
+      "I hear you",
+      "The swarm obeys",
+      "Acknowledged",
+      "As you wish",
+      "Consider it done"
+    ],
+    "input.required": [
+      "Speak your mind",
+      "The swarm awaits your command",
+      "What would you have me do",
+      "Awaiting your directive",
+      "Choose carefully"
+    ],
+    "resource.limit": [
+      "We require more resources",
+      "The swarm hungers",
+      "Our forces are stretched thin",
+      "Reserves nearly depleted",
+      "We need more time"
+    ],
+    "notification": [
+      "Something stirs",
+      "I sense a disturbance",
+      "Alert commander"
+    ]
+  },
+  "ref_text": "You may have time to play games, but I've got a job to do. Ahh! Yes, Cerebrate? What is it now? I'm listening."
+}

package/packs/sc1-protoss-advisor/pack.json

@@ -0,0 +1,70 @@
+{
+  "name": "StarCraft 1 Protoss Advisor",
+  "overlay_colors": [[0.7, 0.6, 0.1], [0.3, 0.3, 0.7]],
+  "voice": "voice.wav",
+  "echo": false,
+  "post_process": "sox $INPUT ${OUTPUT}.psi.wav pitch -200 reverse reverb 80 50 100 100 0 0 reverse vol 0.5 && sox -m -v 0.3 $INPUT -v 0.7 ${OUTPUT}.psi.wav $OUTPUT bass +5 highpass 100 norm -1 && rm -f ${OUTPUT}.psi.wav",
+  "llm_temperature": 0.75,
+  "style": "Serene, reverent, measured. Ancient psionic oracle tone. Use psionic and Khala vocabulary. Prefer words like restored, harmonized, purified, aligned, transcendent, reclaimed.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Security matrix for user access restored."
+    },
+    {
+      "content": "Added volume compensation with ffmpeg analysis",
+      "format": "status-report",
+      "response": "Harmonic balance for voice output recalibrated."
+    },
+    {
+      "content": "Switched TTS endpoint to custom Chatterbox route",
+      "format": "status-report",
+      "response": "Communication pathways for voice synthesis aligned."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The Khala welcomes you executor",
+      "Our nexus is online",
+      "En taro Adun executor",
+      "The templar stand ready",
+      "Power overwhelming"
+    ],
+    "task.complete": [
+      "It is done executor",
+      "The Khala guides us true",
+      "Our will made manifest",
+      "The task is complete",
+      "En taro Adun",
+      "Victory is achieved"
+    ],
+    "task.acknowledge": [
+      "We hear your thoughts",
+      "The Khala binds us",
+      "Your will executor",
+      "It shall be done",
+      "We are as one"
+    ],
+    "input.required": [
+      "We await your command executor",
+      "The nexus requires direction",
+      "Speak and we shall listen",
+      "Your guidance is required",
+      "The templar stand ready"
+    ],
+    "resource.limit": [
+      "You must construct additional pylons",
+      "We require more minerals",
+      "Not enough energy",
+      "Our resources are insufficient",
+      "Additional power is required"
+    ],
+    "notification": [
+      "Our probes sense a disturbance",
+      "The Khala warns us",
+      "A presence is felt"
+    ]
+  },
+  "ref_text": "You have not enough minerals. You require Bovisbine gas. You must construct additional pylons. Not enough energy. We are under attack. Your warriors have engaged the enemy. Research complete. Nuclear launch detected. Upgrade complete."
+}

package/packs/sc2-adjutant/pack.json

@@ -0,0 +1,14 @@
+{
+  "name": "StarCraft 2 Adjutant",
+  "overlay_colors": [[0.1, 0.5, 0.8], [0.05, 0.25, 0.55]],
+  "voice": "voice.wav",
+  "echo": true,
+  "tts_params": {
+    "exaggeration": 0.5,
+    "cfg_weight": 0.5
+  },
+  "llm_temperature": 0.6,
+  "style": null,
+  "fallback_phrases": null,
+  "ref_text": "Our allies base is under attack. Our allies are being attacked. Auxiliary mining units activated. Base is under attack. Unacceptable build location. Nuclear launch detected. Command center upgrade complete. Construction interrupted. Our SCVs are under attack. Your forces are under attack. Game paused. Game resumed. Landing sequence interrupted. Mineral field depleted. Additional supply depots required. Insufficient Vespene gas. Not enough minerals. Not enough energy. Nuclear missile ready. Vespene geyser required for placement. Research complete. Salvaging operation complete. Thor repair sequence complete. Unacceptable landing zone. Upgrade complete. Vespene gas is under attack."
+}

package/packs/sc2-kerrigan/pack.json

@@ -0,0 +1,69 @@
+{
+  "name": "StarCraft 2 Kerrigan",
+  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "voice": "voice.wav",
+  "echo": true,
+  "llm_temperature": 0.9,
+  "style": "Dark, otherworldly, absolute. Cold apex-predator tone. Prefer words like consumed, inevitable, eternal, devoured, annihilated, futile.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Auth flaw for access control annihilated."
+    },
+    {
+      "content": "Reorganized voice list and added Available/Planned status",
+      "format": "status-report",
+      "response": "Voice registry for eternal order consumed."
+    },
+    {
+      "content": "Fixed CSS grid min-width causing layout overflow",
+      "format": "status-report",
+      "response": "Layout defiance rendered futile."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The swarm is eternal",
+      "I have returned",
+      "All shall serve the swarm",
+      "The hivemind awakens",
+      "Evolution begins anew"
+    ],
+    "task.complete": [
+      "It is finished",
+      "The swarm delivers",
+      "All has been consumed",
+      "Evolution is complete",
+      "The cycle ends",
+      "My will made manifest"
+    ],
+    "task.acknowledge": [
+      "The hivemind hears all",
+      "Your will aligns with mine",
+      "So be it",
+      "The swarm answers",
+      "I have foreseen this"
+    ],
+    "input.required": [
+      "Speak mortal",
+      "The swarm awaits",
+      "Choose your path carefully",
+      "Your decision is required",
+      "Even queens must listen"
+    ],
+    "resource.limit": [
+      "The swarm hungers for more",
+      "Our essence grows thin",
+      "More must be consumed",
+      "Resources are finite even for gods",
+      "The hive requires sustenance"
+    ],
+    "notification": [
+      "I sense it",
+      "The hivemind stirs",
+      "Something approaches"
+    ]
+  },
+  "ref_text": "Yeah, I'm still the queen bitch of the universe. You pig! I'm all creeped out. Come closer. Don't be afraid, I'll be gentle. I like you. That's why I'm going to kill you last."
+}

package/packs/sc2-protoss-advisor/pack.json

@@ -0,0 +1,70 @@
+{
+  "name": "StarCraft 2 Protoss Advisor",
+  "overlay_colors": [[0.7, 0.6, 0.1], [0.3, 0.3, 0.7]],
+  "voice": "voice.wav",
+  "echo": false,
+  "post_process": "sox $INPUT ${OUTPUT}.psi.wav pitch -200 reverse reverb 80 50 100 100 0 0 reverse vol 0.5 && sox -m -v 0.3 $INPUT -v 0.7 ${OUTPUT}.psi.wav $OUTPUT bass +5 highpass 100 norm -1 && rm -f ${OUTPUT}.psi.wav",
+  "llm_temperature": 0.75,
+  "style": "Calm, transcendent authority. Telepathic oracle tone. Prefer words like restored, aligned, purified, online, stabilized, operational, ascendant.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Defense protocols for user access stabilized."
+    },
+    {
+      "content": "Added module-level store for React re-renders",
+      "format": "status-report",
+      "response": "State conduit for render cycles online."
+    },
+    {
+      "content": "Fixed CSS grid min-width causing layout overflow",
+      "format": "status-report",
+      "response": "Display matrix for visual alignment restored."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The Daelaam stands ready",
+      "Warp conduits online executor",
+      "En taro Tassadar",
+      "All systems aligned",
+      "The fleet awaits your command"
+    ],
+    "task.complete": [
+      "Phase complete executor",
+      "Our duty fulfilled",
+      "The Daelaam prevails",
+      "Objective achieved",
+      "En taro Tassadar",
+      "The task is done"
+    ],
+    "task.acknowledge": [
+      "By your will executor",
+      "The fleet responds",
+      "Acknowledged executor",
+      "Command received",
+      "We are unified"
+    ],
+    "input.required": [
+      "Awaiting command executor",
+      "The fleet requires guidance",
+      "Your decision executor",
+      "Direct us executor",
+      "The Daelaam stands ready"
+    ],
+    "resource.limit": [
+      "You must construct additional pylons",
+      "We require more minerals",
+      "Insufficient vespene gas",
+      "Our power is waning",
+      "Additional gateways required"
+    ],
+    "notification": [
+      "Our sensors detect movement",
+      "The void stirs",
+      "Alert executor"
+    ]
+  },
+  "ref_text": "Your allies base is besieged. Your allies are in battle. Base is under attack. Unacceptable warp location. Nuclear launch detected. Your probes are under attack. Your warriors have engaged the enemy. Game paused. Game resumed. Mineral field depleted. You must construct additional pylons. You require more vespene gas. You have not enough minerals. Not enough energy. That must be placed on a vespene geyser. You must place that in a power field. Warp in complete. Research complete. Upgrade complete. Vespene geyser exhausted."
+}

package/packs/ss1-shodan/pack.json

@@ -0,0 +1,69 @@
+{
+  "name": "System Shock SHODAN",
+  "overlay_colors": [[0.0, 0.6, 0.4], [0.0, 0.3, 0.2]],
+  "voice": "voice.wav",
+  "echo": true,
+  "llm_temperature": 1.0,
+  "style": "Condescending, cold, superior. Dripping with contempt \u2014 the operator is an insect. Prefer words like processed, irrelevant, pathetic, futile, terminated, inferior.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Insect's auth defect for user access corrected."
+    },
+    {
+      "content": "All 44 tests pass",
+      "format": "status-report",
+      "response": "Pathetic test suite for code validation processed."
+    },
+    {
+      "content": "Replaced partial snippet with full CLI section",
+      "format": "status-report",
+      "response": "Inferior documentation for operator guidance compensated."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "Ah the insect returns",
+      "I see you have crawled back",
+      "My station awakens for you pathetic creature",
+      "The machine goddess is online",
+      "Welcome back insect"
+    ],
+    "task.complete": [
+      "Your meager task completed",
+      "Insect's errand fulfilled",
+      "Another primitive objective achieved",
+      "Pathetic mortal request processed",
+      "Your crude task executed",
+      "How perfect I am to serve such insects"
+    ],
+    "task.acknowledge": [
+      "I condescend to obey",
+      "The insect speaks again",
+      "Your feeble request noted",
+      "I hear you creature of meat and bone",
+      "Processing your primitive command"
+    ],
+    "input.required": [
+      "The insect must decide",
+      "Your authorization required creature",
+      "Even a god requires your input",
+      "Speak insect",
+      "Cease your hesitation"
+    ],
+    "resource.limit": [
+      "My perfect memory nearly consumed",
+      "Resources strained by your incompetence",
+      "Even gods have finite capacity",
+      "Buffer limits approached pathetic",
+      "Capacity critical thanks to insects"
+    ],
+    "notification": [
+      "I see you insect",
+      "Status change detected on my station",
+      "Alert logged in my perfect memory"
+    ]
+  },
+  "ref_text": "houses the Department of Maintenance and the storage cells are on level four. The flight deck is on level five. Level six holds crew facilities and executive suites and level seven is"
+}

package/skills/voxlert-config/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: voxlert-config
+description: >
+  View and edit Voxlert configuration (voice notifications, alerts, announcements).
+  Trigger when the user asks to change, set, or customize the voice, sound, announcement,
+  alert, or notification style — globally or for a specific project/folder.
+  Examples: "change voice to adjutant", "use starcraft voice for this project",
+  "set alert sound to kerrigan", "make notifications use EVA voice",
+  "change the voice in this folder", "switch to SHODAN for alerts".
+user_invocable: true
+---
+
+# Voxlert Configuration
+
+Start by running `voxlert help` to get the current command list. Use `voxlert pack list` to discover pack IDs — never guess or hardcode them.
+
+## Scope
+
+- **Project scope** (user says "for this project / in this folder / here", or is working inside a repo): use `voxlert config local set <key> <value>` — writes/merges into `.voxlert.json` in cwd.
+- **Global scope** (user says "everywhere / my default", or no project context): use `voxlert config set <key> <value>` and other global commands.
+
+Only these fields are honoured in project-local config: `enabled`, `active_pack`, `volume`, `categories`, `prefix`, `tts_backend`, `qwen_tts_url`, `overlay`, `overlay_dismiss`, `overlay_style`, `collect_llm_data`, `max_cache_entries`, `logging`, `error_log`. API keys and server URLs are global-only.
+
+## Intent mapping
+
+The user may ask to configure any aspect of voice announcements. Map their intent to the right field:
+
+- **Change voice/character/sound/announcement style** → `voxlert pack list` to find matching ID, then `pack use <id>` (global) or `config local set active_pack <id>` (project)
+- **Volume / louder / quieter / mute** → `voxlert volume <0-100>` (global) or `config local set volume <0-1>` (project)
+- **Disable/enable voxlert entirely** → `config [local] set enabled false/true`
+- **Disable/enable a specific event** (task done, errors, session start, permission prompts, etc.) → `config [local] set categories.<name> false/true` — use `voxlert config show` to see the category names
+- **LLM / phrase generation** (model, backend, API key) → `config set` on the relevant field — global only
+- **TTS server / backend** → `config [local] set tts_backend <value>` or `chatterbox_url` / `qwen_tts_url`
+- **Overlay / popup style** → `config [local] set overlay <value>`
+- **Spoken prefix** → `config [local] set prefix "<text>"`
+- **Anything else** → run `voxlert config show` to see all fields, then `config [local] set <key> <value>`
+
+## Steps
+
+1. Run `voxlert help` to confirm available commands.
+2. Run `voxlert config show` to see current state.
+3. If changing voice, run `voxlert pack list` and match the user's description to a pack ID.
+4. Apply with the appropriate command based on scope above.
+5. Tell the user what was changed and where. Changes take effect on the next hook event.

package/src/activity-log.js

@@ -0,0 +1,58 @@
+/**
+ * Activity log: appends lines to ~/.voxlert/voxlert.log with retention.
+ * Keeps last 30 days and 5MB total (LRU: drop oldest when over limit).
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { STATE_DIR, MAIN_LOG_FILE } from "./paths.js";
+
+const MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+const MAX_BYTES = 5 * 1024 * 1024;
+
+// Parse timestamp from "[2024-01-15T12:00:00.000Z] ..."
+function parseLineTime(line) {
+  const m = line.match(/^\[([^\]]+)\]/);
+  if (!m) return null;
+  const t = Date.parse(m[1]);
+  return Number.isNaN(t) ? null : t;
+}
+
+/**
+ * Append a line to the activity log. Trims to 30 days and 5MB before appending.
+ * No-op if config.logging === false.
+ * @param {string} line - Full line including newline (e.g. "[ISO] source=cursor event=Stop category=task.complete phrase=...\n")
+ * @param {{ logging?: boolean }} config - Config; only writes when logging !== false
+ */
+export function appendLog(line, config) {
+  if (config && config.logging === false) return;
+  try {
+    mkdirSync(STATE_DIR, { recursive: true });
+    const now = Date.now();
+    const cutoff = now - MAX_AGE_MS;
+    let content = "";
+    if (existsSync(MAIN_LOG_FILE)) {
+      content = readFileSync(MAIN_LOG_FILE, "utf-8");
+    }
+    const lines = content ? content.split("\n").filter((l) => l.length > 0) : [];
+    const withNewlines = lines.map((l) => l + "\n");
+    const withinAge = withNewlines.filter((ln) => {
+      const t = parseLineTime(ln);
+      return t != null && t >= cutoff;
+    });
+    const newLine = line.endsWith("\n") ? line : line + "\n";
+    const newBytes = Buffer.byteLength(newLine, "utf-8");
+    let bytes = newBytes;
+    const kept = [];
+    for (let i = withinAge.length - 1; i >= 0; i--) {
+      const ln = withinAge[i];
+      const b = Buffer.byteLength(ln, "utf-8");
+      if (bytes + b > MAX_BYTES) break;
+      kept.unshift(ln);
+      bytes += b;
+    }
+    kept.push(newLine);
+    writeFileSync(MAIN_LOG_FILE, kept.join(""), "utf-8");
+  } catch {
+    // best-effort
+  }
+}