@antodevs/groundtruth 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,9 +4,36 @@
 
 > Zero-configuration context injection layer for LLM-based coding agents.
 
-![npm](https://img.shields.io/npm/v/groundtruth)
-![license](https://img.shields.io/npm/l/groundtruth)
-![node](https://img.shields.io/node/v/groundtruth)
+![npm](https://img.shields.io/npm/v/@antodevs/groundtruth)
+![github license](https://img.shields.io/github/license/anto0102/GroundTruth)
+![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-blue)
+
+---
+
+## Quick Start (No Install)
+
+Run GroundTruth instantly via `npx`:
+
+### 1. Antigravity Mode (AI Watcher)
+Recommended for automated context injection and skills-based workflows.
+
+```bash
+npx @antodevs/groundtruth --antigravity
+```
+
+### 2. Proxy Mode (Claude Code)
+Intercepts outbound API calls and injects fresh documentation directly into the message payload.
+
+```bash
+npx @antodevs/groundtruth --port 8080
+```
+
+## Installation
+
+To install globally:
+```bash
+npm install -g @antodevs/groundtruth
+```
 
 ---
 
@@ -66,7 +93,7 @@ flowchart TD
 - **Intelligent Chunking**: Groups the filtered dependencies in configurable size batches (default 3) and uniquely hashes them to avoid redundant context-fetching loops unless changes are detected.
 - **Automated Polling**: Periodically fetches updated documentation for the detected stack chunks in parallel.
 - **State Persistence**: Hashes are serialized persistently avoiding redundant DuckDuckGo scraping operations across application crashes.
-- **Block-Based Synchronization**: Writes the parsed context discretely into hash-oriented blocks inside `~/.gemini/GEMINI.md`. Native POSIX bindings are leveraged ensuring `Atomic Writes`. Stale contexts are efficiently garbage-collected via regex matching over tracked batch hashes.
+- **Block-Based Synchronization**: Writes the parsed context discretely into hash-oriented blocks inside `~/.gemini/GEMINI.md`. Native POSIX bindings and intra-device temporary files are leveraged ensuring `Atomic Writes` without EXDEV link errors. Stale contexts are efficiently garbage-collected via regex matching over tracked batch hashes.
 
 ---
 
@@ -80,7 +107,7 @@ npx groundtruth --claude-code
 # Execute your agent in a separate TTY
 claude
 ```
-> **Note:** The daemon automatically mutates your shell environment (`~/.zshrc`, `~/.bashrc`, `config.fish`) to route traffic through the localhost proxy.
+> **Note:** The daemon automatically mutates your shell environment (`~/.zshrc`, `~/.bashrc`, `~/.bash_profile`, `~/.config/fish/config.fish`) to route traffic through the localhost proxy.
 
 ### Usage with Antigravity / Gemini
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antodevs/groundtruth",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lightweight Node.js proxy to intercept API requests from coding agents and inject fresh web context",
   "type": "module",
   "license": "MIT",
@@ -45,4 +45,4 @@
     "linkedom": "^0.18.12",
     "node-fetch": "^3.3.2"
   }
-}
+}

package/specification.yaml

@@ -48,8 +48,8 @@ core_modules:
   - name: cli.js
     responsibilities: 
       - "Process `process.argv` argument parsing."
-      - "Validation and defaulting of arguments (`--port`, `--interval`, `--batch-size`)."
-      - "Help/Docs Screen rendering and early exit conditions."
+      - "Validation and defaulting of arguments (`--port`, `--interval`, `--batch-size`, `--claude-code`, `--antigravity`)."
+      - "Help/Docs Screen rendering and early exit conditions with aesthetic formatting inspired by Claude Code."
   
   - name: search.js
     responsibilities: 
@@ -65,8 +65,8 @@ core_modules:
     responsibilities: 
       - "Read local Node modules context (`package.json`)."
       - "Clean semantic versions (e.g., `^1.2.3` -> `1.2`)."
-      - "Filter out non-informative tooling (`vite`, `prettier`, `eslint`)."
-      - "Group dependencies into manageable batches (`groupIntoBatches`)."
+      - "Filter out non-informative tooling (`vite`, `prettier`, `eslint`, `plugin`, `adapter`, `check`)."
+      - "Group dependencies into manageable batches (default: 3) prioritizing core dependencies over devDependencies."
       - "Generate deterministic MD5 identifiers per batch for block management (`batchHash`)."
       - "Construct search queries based on dependency batches plus temporal identifiers (`latest 2026`)."
   
@@ -109,7 +109,7 @@ core_modules:
 
   - name: utils/atomic-write.js
     responsibilities:
-      - "Creates temporary file blocks performing `fs.rename` (POSIX) or falls back to standard `fs.copyFile` safe-copies (Windows)."
+      - "Creates temporary file blocks inside the target's directory (to prevent EXDEV cross-device link errors) performing `fs.rename` (POSIX) or safe-copies (Windows)."
 
 dependencies:
   runtime: "Node.js >= 18.0.0 (uses ES Modules)"

package/src/utils/atomic-write.js

@@ -17,7 +17,7 @@ import path from 'path';
  */
 export async function atomicWrite(filePath, content, options = {}) {
     const { backup = true, mode = 0o644 } = options;
-    const tempFile = path.join(tmpdir(), `.gt-${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`);
+    const tempFile = path.join(path.dirname(filePath), `.gt-${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`);
     const backupPath = `${filePath}.bak`;
 
     try {