antigravity-plugin-context-mode 1.0.2 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +46 -0
- package/README.md +54 -33
- package/hooks/pre-tool-use.js +393 -41
- package/hooks.json +1 -1
- package/lib/store.js +594 -54
- package/lib/tools.js +6 -2
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/server.js +28 -3
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,52 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to `antigravity-plugin-context-mode` will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## [1.2.1] - 2026-11-15
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
- **CI Test Database Contention (`CONTEXT_MODE_DB_PATH`)**: Updated `getDefaultDbPath()` in `lib/store.js` to respect `process.env.CONTEXT_MODE_DB_PATH`, and configured `tests/test_mcp.js` and `tests/test_hooks.js` to run in dedicated isolated temporary directories. Prevents database lock contention (`SQLITE_BUSY`) during concurrent test execution on multi-core CI runners.
|
|
9
|
+
- **SQLite Busy Timeout**: Added `PRAGMA busy_timeout = 5000;` to database initialization with fallback handling to ensure robust concurrency when multiple processes interact with SQLite in WAL mode.
|
|
10
|
+
- **Category Exemption Group Toggles**: Replaced the long list of individual file exemption chips in the dashboard with clean, one-click category pills (`Images`, `Documents`, `3D Models`, `Music`, `Video`, `Archives`, and `Source Code`). All binary categories default to enabled, with Source Code disabled by default. Added optimistic UI state switching in `toggleCategory()` for instant feedback upon click.
|
|
11
|
+
- **Streamlined Custom File Types**: Restricted the dashboard's exemption tags container to only display user-added custom file types (e.g. `.csv`, `.parquet`, `.log`) with quick removal buttons (`×`).
|
|
12
|
+
- **Status Banner Cleanup**: Replaced `"Live Telemetry"` with **`"Showing stats for: <SCOPE>"`** and removed distracting animations (`animate-ping`, `animate-pulse`) for steady, non-blinking visual indicators.
|
|
13
|
+
- **Dynamic Upper-Right Version Badge**: Displays the active plugin version badge (`v1.2.1`) in the top-right header cluster of the dashboard, populated dynamically from `package.json` via `/api/stats`.
|
|
14
|
+
- **Documentation & Formatting Polishing**: Removed all LaTeX math syntax from `README.md`, replacing it with standard Unicode (`≤ 50 lines`, `≤ 200 lines`, `≤ 800 lines`), and consolidated redundant configuration tables.
|
|
15
|
+
|
|
16
|
+
## [1.2.0] - 2026-11-15
|
|
17
|
+
|
|
18
|
+
### Fixed
|
|
19
|
+
- **Quoted Path Stripping in `PreToolUse`**: Added path argument sanitization to strip enclosing quotes (`"..."`, `'...'`), decode URI schemes (`file:///`), and trim line anchor fragments (`#L...`), preventing `fs.existsSync` failures on Windows when tool calls pass quoted file paths.
|
|
20
|
+
- **Interception Journaling & Telemetry**: Added event journaling on all blocked `read_file` and `run_command` tool calls directly into SQLite (`events` table). Interceptions now immediately update `tokensPreserved`, `keptOutBytes`, `reductionRate`, and the Prompt Payload Comparison bar in the sidecar dashboard.
|
|
21
|
+
- **Dynamic Command Inspection (No Hardcoded Extension Whitelist)**: Refactored `run_command` in `PreToolUse` (`inspectCommand`) to eliminate hardcoded extension regexes completely. Commands invoking `cat`, `type`, `Get-Content`, or `gc` now dynamically extract target paths, check them against the active SQLite cutoff, and respect user-configured exemptions. Safe small files ($\le$ cutoff) and bounded commands (`-Head`, `| Select-Object -First`) are allowed, while wildcard and unpaged dumps are blocked.
|
|
22
|
+
- **UTF-16 & Known Text Exemption Safeguard**: Added `KNOWN_TEXT_EXTENSIONS` check and UTF-16/UTF-8 BOM header inspection to prevent text and code files (such as `.cs` and `.md`) containing null bytes from being misidentified as binary files and bypassing size cutoffs.
|
|
23
|
+
- **Live Interception Feed in Dashboard**: Updated the "Recent Indexed Sources & Interceptions" dashboard panel to display blocked calls (`🛡️ Blocked <tool>: <path>`) with exact saved token metrics alongside indexed FTS5 sources.
|
|
24
|
+
- **Renamed 'Sandbox Cap' to 'Preview Limit'**: Replaced the confusing "Sandbox Cap" label with **`PREVIEW LIMIT`**, clearly indicating the maximum preview slice of command and script output returned into the chat.
|
|
25
|
+
- **Clickable 'Active' / 'Paused' Toggle**: Turned the status badge into an interactive toggle button. Users can click to switch Context Mode between **Active** (pulsing green dot) and **Paused** (amber dot). When paused, the `PreToolUse` hook allows all tool calls through without size checks or command interception, persisting the paused state across active scopes in SQLite.
|
|
26
|
+
- **Fixed Feed Width Truncation**: Removed the hardcoded `max-w-[210px]` container constraint and arbitrary string slice in the dashboard feed, replacing it with responsive `min-w-0 flex-1` flex sizing and clean path formatting (`formatItemPath`) so file and command paths scale dynamically to the full width of the dashboard panel.
|
|
27
|
+
- **Reformatted Metric Rows & Sidebar Layout**: Redesigned the 4 performance metrics into sleek, compact horizontal key-value rows inside a single card (labels on the left, values right-aligned) with subtle hairline dividers. This replaces the tall vertical 12-line card stack in normal sidebars with an information-dense, space-efficient ~140px card that naturally scales to 2 columns on wide screens without wrapping or wasting space.
|
|
28
|
+
- **Unified Lifecycle Gates & System Health (Moved to Bottom)**: Combined `Active Lifecycle Gates` and `Engine & Storage Health` into a single cohesive reference card with an inline `HEALTHY` badge, streamlined gate checkmarks, and compact engine specs. Moved this card to the very bottom of the dashboard so actively changing interactive panels (metrics, exemptions, search, and the live interception feed) remain prominently visible at the top.
|
|
29
|
+
- **Dual-Color Single Progress Bar**: Consolidated the separate raw dump and sandboxed slice progress bars into a single, compact dual-color progress bar placed directly beneath the Live Telemetry status banner. It visually depicts % of context saved in emerald green (`#00e599`) and prompt payload in rose (`#f43f5e`), with live `% saved` text. Removed the redundant middle comparison card and sub-labels since the metric cards directly below inform the user of all exact figures.
|
|
30
|
+
- **User-Friendly Dashboard Terminology**: Replaced cryptic architecture jargon (such as `"SQLite FTS5 Reciprocal Rank Fusion & Sandbox Execution"`, `"Porter BM25 + Trigram RRF"`, and `"Tokens diverted from LLM"`) with clear, value-focused explanations highlighting token savings, context reduction, and keeping LLMs smart, focused, and less forgetful.
|
|
31
|
+
- **Context-Focused Language & Removal of Log Fixation**: Changed card sub-labels from confusing "prompt bloat" phrasing to **`"Context reduced by <size>"`** and **`"Context window preserved"`**, clarifying that user prompts are never deleted or truncated. Removed all narrow fixations on "logs" throughout tooltips, input placeholders, and lifecycle gates to accurately represent all large files, code, and terminal outputs.
|
|
32
|
+
|
|
33
|
+
## [1.1.0] - 2026-11-14
|
|
34
|
+
|
|
35
|
+
### Added
|
|
36
|
+
- **3-Way Telemetry Scope Toggle**: Added seamless switching between **Conversation** (active chat UUID), **Session** (current application run since app restart), and **Lifetime** (all-time cumulative database metrics).
|
|
37
|
+
- **Interactive Cutoff Dropdown**: Scoped cutoff selector (`2 KB`, `4 KB`, `8 KB`, `16 KB`, `32 KB`, `64 KB`, `none`) with persistent SQLite storage and fallback hierarchy.
|
|
38
|
+
- **Dynamic Line Slice Gating**: `PreToolUse` line limit scales dynamically with the cutoff setting (e.g. 2 KB: $\le$50 lines, 4 KB: $\le$100 lines, 8 KB: $\le$200 lines, 16 KB: $\le$400 lines, 32 KB: $\le$800 lines, 64 KB: $\le$1600 lines, none: unrestricted).
|
|
39
|
+
- **Dynamic Sandbox Preview Cap**: `ctx_execute` returned preview text automatically scales to double the active cutoff setting.
|
|
40
|
+
- **Default MS Office Exemptions**: Added `.docx`, `.doc`, `.xlsx`, `.xls`, `.pptx`, `.ppt` alongside `.pdf`, images, and audio/video files to default exemptions.
|
|
41
|
+
- **Clickable Recent Sources**: Click any indexed source in the dashboard to immediately open and view its raw chunks in the Search Inspector.
|
|
42
|
+
- **Exemptions Management Panel**: Live tag editor to add/remove custom file extensions with persistence note and default reset.
|
|
43
|
+
- **Tooltips on Dashboard Metrics**: Added rich context tooltips across all metric cards, lifecycle gates, and SQLite health indicators.
|
|
44
|
+
- **Automated LRU Database Pruning**: Capped stored sources (50 per session, 200 total) to prevent unbounded SQLite growth over long-term use.
|
|
45
|
+
|
|
46
|
+
### Fixed
|
|
47
|
+
- Fixed sidecar token authentication and added dual `GET` & `POST` endpoint support for `/api/cutoff`, `/api/exemptions`, and `/api/purge` to prevent 401/405 errors inside aux pane webviews.
|
|
48
|
+
- Fixed MCP tool server defaulting to generic session instead of binding to `process.env.ANTIGRAVITY_CONVERSATION_ID`.
|
|
49
|
+
- Fixed dashboard metrics crashing on string formatted numbers by adding explicit numeric coercion.
|
|
50
|
+
|
|
5
51
|
## [1.0.2] - 2026-11-14
|
|
6
52
|
|
|
7
53
|
### Fixed
|
package/README.md
CHANGED
|
@@ -1,45 +1,46 @@
|
|
|
1
1
|
# Antigravity Context Mode
|
|
2
2
|
|
|
3
|
-
> **Stop context bloat. Save 90%+ of your prompt tokens. Keep your agent fast, focused, and
|
|
3
|
+
> **Stop context bloat. Save 90%+ of your prompt tokens. Keep your agent fast, focused, and less forgetful.**
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/antigravity-plugin-context-mode)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
[]()
|
|
8
8
|
[]()
|
|
9
9
|
|
|
10
|
-
**Antigravity Context Mode** is a free, local-first plugin built specifically for the **Google Antigravity App**. It prevents terminal commands, build
|
|
10
|
+
**Antigravity Context Mode** is a free, local-first plugin built specifically for the **Google Antigravity App**. It prevents terminal commands, build outputs, multi-megabyte source files, and massive datasets from flooding your conversation history — saving thousands of tokens per turn and stopping "agent amnesia" in its tracks.
|
|
11
11
|
|
|
12
12
|
---
|
|
13
|
-
<img width="
|
|
13
|
+
<img width="817" height="690" alt="Antigravity Context Mode Dashboard" src="https://github.com/user-attachments/assets/dbf6d666-58d0-48f3-bc02-9783acf3fb37" />
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## The Problem: Context Window Bloat
|
|
16
16
|
|
|
17
17
|
When an AI coding agent runs tools, standard workflows dump everything directly into your conversation history:
|
|
18
18
|
|
|
19
19
|
* Running `Get-Content Logs/Editor.log` dumps **65 KB (~16,000 tokens)** into your prompt.
|
|
20
|
-
* Running test suites or
|
|
20
|
+
* Running test suites, compiler outputs, or git diffs dumps **100+ KB** of repetitive text.
|
|
21
21
|
* Reading large source files or documentation dumps **thousands of lines** of irrelevant boilerplate.
|
|
22
22
|
|
|
23
23
|
### Why this hurts:
|
|
24
|
-
1. **Agent Amnesia**: Important system instructions and
|
|
25
|
-
2. **
|
|
26
|
-
3. **Burned Quota &
|
|
24
|
+
1. **Agent Amnesia**: Important system instructions, user constraints, and earlier architectural decisions get drowned out ("lost in the middle").
|
|
25
|
+
2. **Slower Responses**: Model evaluation and generation times climb as the context window fills up.
|
|
26
|
+
3. **Burned Quota & Ceilings**: You hit model context limits and rate limits after only a few turns.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
-
##
|
|
30
|
+
## The Solution: How Context Mode Works
|
|
31
31
|
|
|
32
32
|
```text
|
|
33
33
|
┌────────────────────────────────────────────────────────────────────────┐
|
|
34
34
|
│ ANTIGRAVITY AGENT │
|
|
35
35
|
└───────────────────────────────────┬────────────────────────────────────┘
|
|
36
36
|
│
|
|
37
|
-
Tool Call (e.g. read large
|
|
37
|
+
Tool Call (e.g. read large file/command)
|
|
38
38
|
▼
|
|
39
39
|
┌────────────────────────────────────────────────────────────────────────┐
|
|
40
40
|
│ PRE-TOOL-USE LIFECYCLE HOOK GATE │
|
|
41
|
-
│ • Blocks unbounded dumps (cat
|
|
41
|
+
│ • Blocks unbounded dumps (cat, Get-Content, git diff) │
|
|
42
42
|
│ • Enforces 8 KB cutoff for un-paged file reads │
|
|
43
|
+
│ • Automatically exempts binary media, documents, & prompt attachments │
|
|
43
44
|
└───────────────────┬────────────────────────────────┬───────────────────┘
|
|
44
45
|
│ │
|
|
45
46
|
Under 8 KB (Safe) Over 8 KB (Blocked)
|
|
@@ -54,20 +55,20 @@ When an AI coding agent runs tools, standard workflows dump everything directly
|
|
|
54
55
|
└───────────────────────────────────┘
|
|
55
56
|
│
|
|
56
57
|
▼
|
|
57
|
-
Returns only the
|
|
58
|
-
|
|
58
|
+
Returns only the filtered,
|
|
59
|
+
relevant answer to the chat!
|
|
59
60
|
```
|
|
60
61
|
|
|
61
|
-
1. **Smart Lifecycle Gating (`hooks.json`)**: Before a command or file read executes, Context Mode checks if it will cause a
|
|
62
|
-
2. **"Thinking in Code" (`ctx_execute`)**: Instead of reading a 5,000-line log into memory, the agent executes a
|
|
63
|
-
3. **SQLite FTS5 Storage (`ctx_search`, `ctx_index`)**:
|
|
64
|
-
4. **Live Sidecar Dashboard**: A native side pane right inside the Antigravity App that displays
|
|
62
|
+
1. **Smart Lifecycle Gating (`hooks.json`)**: Before a command or file read executes, Context Mode checks if it will cause a context flood. If it exceeds 8 KB or attempts an unbounded file dump, the hook intercepts it and guides the agent to query or sandbox the data instead.
|
|
63
|
+
2. **"Thinking in Code" (`ctx_execute`)**: Instead of reading a 5,000-line log into memory, the agent executes a concise local script (Node.js, Python, or PowerShell). The script filters the data in **50 ms** and returns *only* the specific answer or error to the conversation.
|
|
64
|
+
3. **Local SQLite FTS5 Storage (`ctx_search`, `ctx_index`)**: Raw outputs are saved safely on your local disk in `~/.context-mode/context.db`. The agent uses reciprocal rank fusion search to fetch only the exact snippets it needs.
|
|
65
|
+
4. **Live Sidecar Dashboard**: A native side pane right inside the Antigravity App that displays real-time context savings, lets you toggle file categories on the fly, and search indexed data with a click.
|
|
65
66
|
|
|
66
67
|
---
|
|
67
68
|
|
|
68
|
-
##
|
|
69
|
+
## Proven Results
|
|
69
70
|
|
|
70
|
-
Tested live on real
|
|
71
|
+
Tested live on real-world build logs, source files, and datasets in the Antigravity App:
|
|
71
72
|
|
|
72
73
|
| Operation | Without Context Mode | With Context Mode | Savings |
|
|
73
74
|
| :--- | :---: | :---: | :---: |
|
|
@@ -77,7 +78,7 @@ Tested live on real Unity 6.6 build and engine logs in the Antigravity App:
|
|
|
77
78
|
|
|
78
79
|
---
|
|
79
80
|
|
|
80
|
-
##
|
|
81
|
+
## Quick Start & Installation
|
|
81
82
|
|
|
82
83
|
### Option 1: Global User Install (Recommended)
|
|
83
84
|
Installs Context Mode for all your projects and conversations:
|
|
@@ -105,19 +106,35 @@ npm install -g antigravity-plugin-context-mode
|
|
|
105
106
|
|
|
106
107
|
---
|
|
107
108
|
|
|
108
|
-
##
|
|
109
|
+
## Live Auxiliary Sidecar Dashboard
|
|
109
110
|
|
|
110
111
|
Context Mode includes a native web dashboard that opens directly in Antigravity's **Auxiliary (Side) Pane**:
|
|
111
112
|
|
|
112
113
|
* **One-Click Open Pill:** Click `[Open Context Mode Dashboard](sidecar://antigravity-plugin-context-mode/dashboard/)` in chat anytime.
|
|
113
|
-
* **
|
|
114
|
-
* **
|
|
115
|
-
* **
|
|
114
|
+
* **Active / Paused Toggle:** Click the status pill in the top header to instantly pause protection when you intentionally need un-gated operations, and click again to re-activate.
|
|
115
|
+
* **Dynamic Version Badge:** Automatically reflects the active plugin version in the top-right header.
|
|
116
|
+
* **Context Saved Progress Bar:** Visual indicator displaying the exact percentage of context window preserved.
|
|
117
|
+
* **3-Way Scope Toggle:** Seamlessly inspect telemetry at three distinct levels:
|
|
118
|
+
* **Conversation**: Metrics strictly for the active chat; clean slate on new conversations.
|
|
119
|
+
* **Session**: Metrics aggregated across all conversations since the app restarted.
|
|
120
|
+
* **Lifetime**: All-time cumulative database metrics and persistent totals.
|
|
121
|
+
* **File Category Toggles:** Clean, one-click pills for grouping exemptions without reading massive lists:
|
|
122
|
+
* **Images** (`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`, `.bmp`, `.ico`, `.tiff`, `.psd`) — *Enabled by default*
|
|
123
|
+
* **Documents** (`.pdf`, `.docx`, `.doc`, `.xlsx`, `.xls`, `.pptx`, `.ppt`, `.odt`, `.rtf`) — *Enabled by default*
|
|
124
|
+
* **3D Models** (`.blend`, `.fbx`, `.obj`, `.gltf`, `.glb`, `.stl`, `.dae`, `.3ds`, `.step`, `.iges`) — *Enabled by default*
|
|
125
|
+
* **Music** (`.mp3`, `.wav`, `.ogg`, `.flac`, `.aac`, `.m4a`, `.wma`, `.midi`) — *Enabled by default*
|
|
126
|
+
* **Video** (`.mp4`, `.mov`, `.avi`, `.mkv`, `.webm`, `.flv`, `.wmv`, `.m4v`) — *Enabled by default*
|
|
127
|
+
* **Archives** (`.zip`, `.tar`, `.gz`, `.7z`, `.rar`, `.wasm`) — *Enabled by default*
|
|
128
|
+
* **Source Code** (`.js`, `.ts`, `.py`, `.rs`, `.go`, `.java`, `.c`, `.cpp`, `.cs`, `.html`, `.css`, etc.) — *Disabled by default to protect context*
|
|
129
|
+
* **Custom File Extensions:** Dedicated section displaying only user-added file extensions (e.g. `.csv`, `.parquet`, `.log`) with instant removal.
|
|
130
|
+
* **Chat Attachment Exemption:** Files attached directly in chat messages (`@` mentions and drag-and-drops) always bypass size cutoffs so the agent can inspect them in full.
|
|
131
|
+
* **Interactive Cutoff Dropdown:** Switch size cutoffs on the fly (`2 KB`, `4 KB`, `8 KB`, `16 KB`, `32 KB`, `64 KB`, or `none`). Line slice limits scale dynamically (2 KB: ≤ 50 lines, 8 KB: ≤ 200 lines, 32 KB: ≤ 800 lines).
|
|
132
|
+
* **Interactive FTS5 Search Inspector:** Search your indexed logs and files directly from the UI to inspect what the agent has indexed.
|
|
116
133
|
* **1-Click Session Purge:** Wipe session indexes and reset counters whenever you start a fresh task.
|
|
117
134
|
|
|
118
135
|
---
|
|
119
136
|
|
|
120
|
-
##
|
|
137
|
+
## Available MCP Tools
|
|
121
138
|
|
|
122
139
|
Once installed, the following 8 tools are registered in your Antigravity App:
|
|
123
140
|
|
|
@@ -127,21 +144,23 @@ Once installed, the following 8 tools are registered in your Antigravity App:
|
|
|
127
144
|
| **`ctx_search`** | Searches SQLite FTS5 using BM25 stemming and Trigram matching. | Finding error codes, method names, or stack traces in past logs. |
|
|
128
145
|
| **`ctx_index`** | Indexes local files, web URLs, or text into searchable chunks. | Indexing a 1,000-line documentation file or architecture spec. |
|
|
129
146
|
| **`ctx_batch`** | Runs multiple shell commands in batch and indexes the combined output. | Running `git status`, `git log`, and `npm test` in one compact call. |
|
|
130
|
-
| **`ctx_stats`** | Displays a formatted
|
|
147
|
+
| **`ctx_stats`** | Displays a formatted savings report and token metrics. | Checking how many tokens were saved during your session. |
|
|
131
148
|
| **`ctx_resume`** | Returns recent indexed sources and state pointers. | Re-orienting the agent after context compaction. |
|
|
132
149
|
| **`ctx_doctor`** | Checks SQLite database health, WAL mode, and active runtimes. | Verifying database integrity and platform runtimes. |
|
|
133
150
|
| **`ctx_purge`** | Clears stored sources and events from SQLite. | Resetting session or worktree indexes. |
|
|
134
151
|
|
|
135
152
|
---
|
|
136
153
|
|
|
137
|
-
##
|
|
154
|
+
## Configuration & Environment Variables
|
|
138
155
|
|
|
139
|
-
You can customize Context Mode's cutoffs at any time using environment variables:
|
|
156
|
+
You can customize Context Mode's cutoffs at any time using the dashboard dropdown or environment variables:
|
|
140
157
|
|
|
141
158
|
| Variable | Default | Description |
|
|
142
159
|
| :--- | :---: | :--- |
|
|
143
|
-
| `CONTEXT_MODE_MAX_READ_BYTES` | `8192` (8 KB) |
|
|
144
|
-
| `CONTEXT_MODE_MAX_LINE_RANGE` | `200`
|
|
160
|
+
| `CONTEXT_MODE_MAX_READ_BYTES` | `8192` (8 KB) | Size threshold beyond which un-paged file reads are rejected. Set `0` to disable. |
|
|
161
|
+
| `CONTEXT_MODE_MAX_LINE_RANGE` | *Dynamic* (or `200`) | Maximum allowable line slice range before pagination rejection (scales with cutoff). |
|
|
162
|
+
| `CONTEXT_MODE_MAX_OUTPUT_BYTES` | *Dynamic* (or `16384`) | Maximum raw preview bytes returned by `ctx_execute` (defaults to 2x cutoff). |
|
|
163
|
+
| `CONTEXT_MODE_TIMEOUT_MS` | `30000` (30s) | Execution timeout for sandboxed code snippets. |
|
|
145
164
|
|
|
146
165
|
### How to set on Windows (PowerShell):
|
|
147
166
|
```powershell
|
|
@@ -155,7 +174,7 @@ export CONTEXT_MODE_MAX_READ_BYTES=4096
|
|
|
155
174
|
|
|
156
175
|
---
|
|
157
176
|
|
|
158
|
-
##
|
|
177
|
+
## Privacy & Zero Dependencies
|
|
159
178
|
|
|
160
179
|
* **100% Local**: All indexed data lives on your machine in `~/.context-mode/context.db`. Zero network calls are made.
|
|
161
180
|
* **Zero 3rd-Party Dependencies**: Built exclusively on native Node.js (`node:sqlite` / `DatabaseSync`, `child_process`, and `http`). No native C++ builds, no `node-gyp`, and no dependency security vulnerabilities.
|
|
@@ -163,7 +182,7 @@ export CONTEXT_MODE_MAX_READ_BYTES=4096
|
|
|
163
182
|
|
|
164
183
|
---
|
|
165
184
|
|
|
166
|
-
##
|
|
185
|
+
## Running Tests
|
|
167
186
|
|
|
168
187
|
Context Mode ships with a complete test suite using Node's native test runner:
|
|
169
188
|
|
|
@@ -176,10 +195,12 @@ Verifies:
|
|
|
176
195
|
* Reciprocal Rank Fusion (RRF) ranking.
|
|
177
196
|
* Sandbox execution and process timeout termination.
|
|
178
197
|
* `PreToolUse` and `SessionStart` lifecycle hook gating.
|
|
198
|
+
* File category toggles and custom extension management.
|
|
199
|
+
* Active / Paused state toggle and bypass logic.
|
|
179
200
|
* MCP stdio JSON-RPC protocol compliance.
|
|
180
201
|
|
|
181
202
|
---
|
|
182
203
|
|
|
183
|
-
##
|
|
204
|
+
## License
|
|
184
205
|
|
|
185
206
|
MIT © [Phillip Webber](https://github.com/Domush)
|