agy-context-saver 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to `Agy-Context-Saver` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.1] - 2026-10-07
+
+### Documentation & Developer Experience
+- **MCP Prompts Documentation**: Formally documented the `/mcp:agy-context-saver:context_shield` prompt across `README.md` and the documentation site, clarifying the operational difference between user slash commands (Prompts) and autonomous agent capabilities (Tools).
+- **Quickstart Optimization**: Repositioned the Quickstart installation block to the very top of `README.md` and `docs/index.md` for immediate onboarding.
+- **Zensical Docs Site Overhaul**: Added `context_shield` reference and tip callouts across `docs/index.md`, `docs/tools.md`, and `docs/governance.md`; updated navigation title to `Tools & Prompts`.
+- **Dynamic Test Assertions**: Updated installed MCP server verification test to dynamically synchronize with `package.json` version.
+
+---
+
+## [1.2.0] - 2026-10-07
+
+### Performance & Forensics
+- **Batch Full-Transcript Dereferencing**: Replaced sequential full-transcript scans with `batchFindFullSteps()`, reducing $N$-item dereferencing from $O(N)$ full-file passes down to a single streaming pass ($O(1)$) in 18.4ms.
+- **Sliding-Window Turn Retention**: Bounded transcript memory retention in `read_transcript` (`WINDOW_SIZE = Math.max(100, lastTurns * 15)`) with an early-stopping block formatter, parsing 2,000 steps in 21.8ms under 24 KB memory.
+- **Regex LRU Caching**: Added in-memory LRU cache (`regexCache`, capacity: 100) for query pattern compilation in `query_transcript`.
+- **Short-Circuit Field Search**: Converted transcript search to test fields sequentially (`content` $\to$ `thinking` $\to$ `tool_calls`), avoiding heavy string concatenations.
+- **Fast-Path Message Cleaning**: Added fast-path bypass in `cleanMessageContent` for strings $\le 120$ characters, eliminating redundant base64 regexes and newline splits.
+- **Static Rules In-Memory Cache**: Cached `rules/AGENTS.md` in memory with `mtimeMs` file stat invalidation, eliminating disk I/O on `resources/read` and `prompts/get`.
+
+### Execution Governor & Hook
+- **Fast-Path Builtin Bypass**: Added `NON_REWRITABLE_BINARIES` set (`node`, `powershell`, `pwsh`, `cmd`, `dir`, `echo`, `cd`, `del`, etc.) and PowerShell cmdlet prefixes to bypass `spawnSync("rtk")`, dropping execution latency from ~30ms to $< 0.05$ms.
+- **Persistent Command Rewrite LRU Cache**: Implemented persistent disk LRU cache (`agy-rtk-rewrite-cache.json` in `os.tmpdir()`) for rewritable commands, reducing repeat rewrite lookups to $< 0.1$ms.
+- **Session Ledger State Partitioning**: Partitioned session state by conversation ID (`agy-session-${safeId}.json`) to eliminate cross-session file contention.
+
+### Registration & Lifecycle
+- **Idempotent Config & Schema Synchronization**: Added `safeWriteFileIfChanged` and `safeCopyFileIfChanged` across all configuration (`hooks.json`, `mcp_config.json`) and MCP tool schemas (`~/.gemini/antigravity/mcp/agy-context-saver/`), eliminating disk churn during repeat syncs.
+- **RTK Provisioning Check Reuse**: Passed pre-detected RTK metadata to `ensureRtkInstalled()` to eliminate redundant `execSync` version checks during installation.
+
+### Security & Reliability
+- **Stdio Payload Safety Ceiling**: Added 10 MB payload guard (`MAX_STDIO_PAYLOAD_BYTES`) on the MCP stdio line reader, emitting standard JSON-RPC `-32600 Invalid Request` on oversized payloads.
+- **New Performance Verification Suite**: Added `tests/test-performance-probes.mjs` verifying batch dereferencing, sliding window bounds, stdio safety ceiling, and idempotent writes.
+
+---
+
+## [1.1.0] - 2026-10-07
+
+### Added
+- **Closed Execution Topology & Governance Invariants**: Comprehensive PreToolUse hook intercepting native inspection tools (`view_file`, `grep_search`, `list_dir`, `find_by_name`) and hard-routing them to RTK.
+- **Root-Based Antigravity State Protection**: Denied direct access to `.system_generated/` internal files to prevent transcript bloat and loop degradation.
+- **Session-Wide Lifecycle Ledger**: Non-resettable session task polling counter with Tier 3 `force_ask` circuit breaker at 5 denials.
+- **Evaluator & Benchmark Mutation Safeguard**: Gated mutation of evaluator or benchmark artifacts behind user confirmation.
+- **Platform-Aware Windows Routing**: Windows-native routing for `rtk rg "<pattern>" .` and `rtk find <path>` to eliminate stdin hangs.
+- **Universal MCP Server**: 6 core tools (`check_context_health`, `subagent_brief`, `get_installation_status`, `sync_installation`, `read_transcript`, `query_transcript`).
+
+---
+
+## [1.0.0] - 2026-10-07
+
+### Initial Release
+- Initial release of Agy-Context-Saver.
+- Antigravity Model Context Protocol (MCP) server.
+- Background task lifecycle governance and reactive wakeup enforcement.

package/README.md

@@ -13,6 +13,23 @@ It permanently eliminates session degradation, memory bloat, and context window
 
 ---
 
+## Quickstart (Instant Install)
+
+Install and synchronize the governor and RTK across your Antigravity environment:
+
+```bash
+# Fastest: one-line registration via npx
+npx agy-context-saver install
+
+# Or locally from this repository
+npm run setup
+
+# Audit health across all layers at any time
+npm run status
+```
+
+---
+
 ## Architectural Division of Responsibilities
 
 ```text
@@ -65,23 +82,6 @@ It permanently eliminates session degradation, memory bloat, and context window
 
 ---
 
-## Quickstart (Instant Install)
-
-Install and synchronize the governor and RTK across your Antigravity environment:
-
-```bash
-# Fastest: one-line registration via npx
-npx agy-context-saver install
-
-# Or locally from this repository
-npm run setup
-
-# Audit health across all layers at any time
-npm run status
-```
-
----
-
 ## Key Capabilities
 
 - **Transparent RTK Rewriting**: Native `run_command` calls are automatically rewritten (e.g. `pytest` $\to$ `rtk pytest`) via Antigravity PreToolUse hooks.
@@ -154,14 +154,17 @@ node tests/test-lifecycle-rollback.mjs
 
 ---
 
-## Available MCP Tools
-
-1. `check_context_health`: Diagnoses conversation transcript turn budgets, payload size, RTK status, and polling loops.
-2. `subagent_brief`: Formulates scope-isolated prompts for delegated subagents.
-3. `read_transcript`: Reads recent conversation history in clean Markdown format (compact/full).
-4. `query_transcript`: Forensic filtering and regex search engine for conversation logs.
-5. `get_installation_status`: Inspects live Antigravity plugin link, hook, MCP server, tool schemas, and RTK binary.
-6. `sync_installation`: Re-verifies and repairs all integration layers in ~25ms.
+## MCP Tools & Slash Commands
+
+* **User Slash Command (`/mcp:...`)**:
+  - `/mcp:agy-context-saver:context_shield`: Injects 3-layer governance rules and RTK standards into any session with one click. *(MCP Prompts appear in your chat autocomplete menu; MCP Tools are called autonomously by the agent).*
+* **Agent MCP Tools**:
+  1. `check_context_health`: Diagnoses conversation transcript turn budgets, payload size, RTK status, and polling loops.
+  2. `subagent_brief`: Formulates scope-isolated prompts for delegated subagents.
+  3. `read_transcript`: Reads recent conversation history in clean Markdown format (compact/full).
+  4. `query_transcript`: Forensic filtering and regex search engine for conversation logs.
+  5. `get_installation_status`: Inspects live Antigravity plugin link, hook, MCP server, tool schemas, and RTK binary.
+  6. `sync_installation`: Re-verifies and repairs all integration layers in ~25ms.
 
 ---
 

package/mcp/index.js

@@ -51,7 +51,7 @@ if (cliArg === "install" || cliArg === "--install") {
 
 function printHelp() {
   console.log(`
-Agy-Context-Saver 🛡️ (v1.2.0)
+Agy-Context-Saver 🛡️ (v1.2.1)
 Universal MCP Server & Lifecycle Governor for Google Antigravity (Powered by RTK)
 
 Usage:
@@ -98,7 +98,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const rulesPath = path.resolve(__dirname, "../rules/AGENTS.md");
 
 const SERVER_NAME = "agy-context-saver";
-const SERVER_VERSION = "1.2.0";
+const SERVER_VERSION = "1.2.1";
 
 // --- Tools Specification ---
 const TOOLS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-context-saver",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Universal Model Context Protocol (MCP) server & lifecycle governor purpose-built for Google Antigravity",
   "main": "mcp/index.js",
   "bin": {
@@ -34,6 +34,7 @@
     "install.ps1",
     "install.sh",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "author": "paragon-ux",

package/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "agy-context-saver",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Deterministic background polling governor and subagent context preservation shield for Antigravity"
 }