tzero-mcp 10.7.0 → 10.7.2

package/CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# Contributing to T-Zero
+
+Thank you for your interest in contributing to **T-Zero**! We welcome community contributions, bug reports, and performance optimizations from engineers worldwide.
+
+---
+
+## 🛠 Local Development Setup
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/toprakahmetaydogmus/TZeroAlgorithm.git
+   cd TZeroAlgorithm
+   ```
+
+2. **Create a virtual environment:**
+   ```bash
+   python -m venv .venv
+   # Windows:
+   .venv\Scripts\activate
+   # Linux/macOS:
+   source .venv/bin/activate
+   ```
+
+3. **Install dependencies and editable package:**
+   ```bash
+   pip install -e ".[test,build]"
+   ```
+
+---
+
+## 🧪 Verification Pipeline Before Submitting a PR
+
+Before opening a pull request, ensure all verification gates pass locally:
+
+1. **Syntax Check:**
+   ```bash
+   python -m py_compile $(git diff --name-only HEAD | grep '\.py$')
+   ```
+
+2. **Run Zero-Leak Secret Audit:**
+   ```bash
+   python tests/audit_secrets.py
+   # Must return: Total secret audit findings: 0
+   ```
+
+3. **Run Unit Tests:**
+   ```bash
+   python -m unittest discover tests -v
+   ```
+
+4. **Run Empirical Task Benchmark:**
+   ```bash
+   python tzero_task_benchmark.py
+   ```
+
+---
+
+## 📐 Code Style & Architecture Guidelines
+
+- **Determinism First:** All AST parsing, BM25 searching, and token reduction must run 100% locally with zero external network telemetry.
+- **Inward Dependencies:** Core modules (`tzero_packer`, `tzero_guard`) must not depend on outer presentation layers (`tzero_tui`, `tzero_gui`).
+- **No Plaintext Secrets:** Never commit API keys, connection URIs, or high-entropy tokens.
+- **Air-Gapped Compliance:** Respect `TZERO_NO_AUTO_INSTALL=1` across all scripts.
+
+---
+
+## 💬 Community & Discussions
+
+- **GitHub Issues:** [Bug Reports & Feature Requests](https://github.com/toprakahmetaydogmus/TZeroAlgorithm/issues)
+- **Hugging Face Space:** [Interactive Web Demo](https://huggingface.co/spaces/toprakke4/tzero-token-reducer)
+- **Maintainer:** Toprak Ahmet Aydoğmuş (`siberakademi@org.tr`)

package/README.md

@@ -2,55 +2,63 @@
 
 > **Deterministic AST Context Compressor, 95% Token Reducer & 20-Tool MCP Server for Cursor, Claude Desktop, Antigravity & Copilot.**
 
-[![npm version](https://img.shields.io/npm/v/tzero-mcp.svg)](https://www.npmjs.com/package/tzero-mcp)
+[![npm version](https://img.shields.io/npm/v/tzero-mcp.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/tzero-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Socket Badge](https://socket.dev/api/badge/npm/package/tzero-mcp)](https://socket.dev/npm/package/tzero-mcp)
 [![GitHub Stars](https://img.shields.io/github/stars/toprakahmetaydogmus/TZeroAlgorithm?style=social)](https://github.com/toprakahmetaydogmus/TZeroAlgorithm)
 
 ---
 
-### ⭐ Built by a 15-Year-Old Solo Developer
-Hi! I'm **Toprak Ahmet Aydoğmuş**, a 15-year-old developer from Siber Akademi. I created T-Zero to solve LLM token limits and eliminate AI coding hallucinations using deterministic AST analysis. If you find this package useful, **please star our repository on GitHub!**
+### ⭐ Built by a 15-Year-Old Solo Developer (Please Star Our Repo!)
 
-👉 **[https://github.com/toprakahmetaydogmus/TZeroAlgorithm](https://github.com/toprakahmetaydogmus/TZeroAlgorithm)**
+Hi! I'm **Toprak Ahmet Aydoğmuş**, a 15-year-old solo open-source developer from **Siber Akademi**. I created T-Zero from scratch to eliminate token limits, reduce prompt costs by up to 95%, and stop AI coding hallucinations using deterministic Abstract Syntax Tree (AST) analysis.
+
+If this package helps your engineering team or AI workflows:  
+⭐ **Please give our repository a STAR on GitHub:**  
+👉 **[https://github.com/toprakahmetaydogmus/TZeroAlgorithm](https://github.com/toprakahmetaydogmus/TZeroAlgorithm)**  
+*Every single star means the world to a young open-source creator! 🚀*
 
 ---
 
-## ⚡ Instant MCP Execution (No Install Needed)
+## ⚡ Instant MCP Execution (Zero Install Needed)
 
-Run directly via `npx` in your `claude_desktop_config.json` or Cursor MCP settings:
+Run directly via `npx` in your `claude_desktop_config.json`, Cursor MCP settings, or Windsurf / Antigravity config:
 
 ```json
 {
   "mcpServers": {
     "tzero": {
       "command": "npx",
-      "args": ["-y", "tzero-mcp"]
+      "args": ["-y", "tzero-mcp@latest"]
     }
   }
 }
 ```
 
-## 🚀 CLI Installation
+## 🚀 CLI Installation & Usage
 
 ```bash
-# Global installation
+# Global installation via npm
 npm install -g tzero-mcp
 
-# Compress a directory into an AST Skeleton tree (95% token savings)
+# Compress any project directory into an AST Skeleton tree (95% token savings)
 tzero --tree . --out tree.txt
 
-# Launch MCP Server
+# Launch interactive Model Context Protocol (MCP) Server
 tzero-mcp
+
+# 1-Click connect to Cursor, Claude Desktop, Antigravity & VS Code
+tzero-add-mcp
 ```
 
-## 🛠 Features
+## 🛠 Key Capabilities
 
-- **95% Token Reduction:** Compresses source code into AST skeletons with intact function signatures and docstrings.
-- **Zero-Leak Security Guard:** Scans for hardcoded secrets before LLM context ingestion.
-- **Reality-Lock Pre-Flight:** Prevents hallucinations by verifying imports and function calls against AST.
-- **20 Native Tools:** Memory store, AST pagerank, call chain tracer, diff context, and more.
+- **95% Deterministic Token Reduction:** Compresses source code into AST skeletons preserving function signatures, type annotations, and docstrings while pruning redundant logic bodies.
+- **100% Zero-Leak Security Guard:** Deep Shannon Entropy ($H \ge 4.75$) scanner for API keys and secrets before LLM context ingestion.
+- **Reality-Lock Pre-Flight:** Catches hallucinations before code execution by validating imports and call hierarchies against real AST nodes.
+- **20 Native Developer Tools:** AST PageRank, call-chain tracer, BM25 semantic hybrid search, change blast radius analyzer, and system doctor.
+- **100% Private, Local & Free:** Pure offline operation — $0 API cost, zero cloud lock-in.
 
 ## 📄 License
 
 MIT © [Toprak Ahmet Aydoğmuş](https://github.com/toprakahmetaydogmus)
-

package/bin/postinstall.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+/**
+ * T-Zero Post-Install Banner & Star Request
+ * Author: Toprak Ahmet Aydoğmuş (15-Year-Old Solo Developer @ Siber Akademi)
+ * Repository: https://github.com/toprakahmetaydogmus/TZeroAlgorithm
+ */
+
+const isCI = process.env.CI || process.env.CONTINUOUS_INTEGRATION;
+if (!isCI) {
+  const cyan = "\x1b[36m";
+  const yellow = "\x1b[33m";
+  const green = "\x1b[32m";
+  const bold = "\x1b[1m";
+  const reset = "\x1b[0m";
+
+  console.log(`
+${yellow}┌──────────────────────────────────────────────────────────────────────────────┐
+│  ${bold}${green}⚡ T-ZERO CONTEXT ARCHITECT & MCP SERVER INSTALLED SUCCESSFULLY!${reset}${yellow}            │
+│                                                                              │
+│  Hi! I'm ${bold}Toprak Ahmet Aydoğmuş${reset}${yellow}, a 15-year-old solo developer from         │
+│  ${bold}Siber Akademi${reset}${yellow}. I built T-Zero from scratch to eliminate token bloat and    │
+│  AI coding hallucinations using deterministic AST analysis.                  │
+│                                                                              │
+│  ⭐ ${bold}If T-Zero saves you tokens or helps your AI workflows,${reset}${yellow}                 │
+│     ${bold}${cyan}please give our repository a STAR on GitHub:${reset}${yellow}                            │
+│                                                                              │
+│  👉 ${bold}${cyan}https://github.com/toprakahmetaydogmus/TZeroAlgorithm${reset}${yellow}                    │
+│                                                                              │
+│  Every star means the world to a young open-source creator! 🚀 Thank you!    │
+└──────────────────────────────────────────────────────────────────────────────┘${reset}
+`);
+}
+process.exit(0);

package/bin/tzero-mcp.js

@@ -8,15 +8,21 @@
 
 const { spawn, execSync } = require("child_process");
 const process = require("process");
+const path = require("path");
+const pkg = require("../package.json");
 
 // In MCP mode, banner is printed to stderr to keep stdout strictly for JSON-RPC
 const banner = `\x1b[33m
 ┌──────────────────────────────────────────────────────────────────────────────┐
-│  ⭐ T-ZERO MCP SERVER v10.7.0 (Model Context Protocol)                       │
+│  ⭐ T-ZERO MCP SERVER v${pkg.version} (Model Context Protocol)                       │
 │                                                                              │
 │  Hi! I'm Toprak Ahmet Aydoğmuş, a 15-year-old developer from Siber Akademi. │
-│  If this tool helps you, please star:                                        │
+│  I created T-Zero to eliminate token limits & hallucinations.                │
+│                                                                              │
+│  If T-Zero helps your workflows, please give our project a STAR on GitHub:   │
 │  👉 https://github.com/toprakahmetaydogmus/TZeroAlgorithm                    │
+│                                                                              │
+│  Every star means the world to a young open-source creator! 🚀 Thank you!    │
 └──────────────────────────────────────────────────────────────────────────────┘
 \x1b[0m`;
 
@@ -44,25 +50,16 @@ if (!py) {
   process.exit(1);
 }
 
-// Ensure tzero_mcp module is installed in this python environment
-try {
-  execSync(`${py} -c "import tzero_mcp"`, { stdio: "ignore" });
-} catch (e) {
-  if (process.stderr.isTTY) {
-    process.stderr.write("\x1b[36m[T-Zero] First-time setup: installing tzero-mcp from PyPI...\x1b[0m\n");
-  }
-  try {
-    execSync(`${py} -m pip install -U tzero-mcp`, { stdio: "inherit" });
-  } catch (err) {
-    console.error("\x1b[31m[ERROR] Failed to auto-install tzero-mcp. Please run: pip install -U tzero-mcp\x1b[0m");
-    process.exit(1);
-  }
-}
+const srcDir = path.resolve(__dirname, "..", "src");
+const scriptPath = path.join(srcDir, "tzero_mcp.py");
+
+const env = Object.assign({}, process.env, {
+  PYTHONPATH: srcDir + (process.env.PYTHONPATH ? path.delimiter + process.env.PYTHONPATH : "")
+});
 
-const args = ["-m", "tzero_mcp", ...process.argv.slice(2)];
-const child = spawn(py, args, { stdio: "inherit" });
+const args = [scriptPath, ...process.argv.slice(2)];
+const child = spawn(py, args, { stdio: "inherit", env });
 
 child.on("close", (code) => {
   process.exit(code ?? 0);
 });
-

package/bin/tzero.js

@@ -8,16 +8,20 @@
 
 const { spawn, execSync } = require("child_process");
 const process = require("process");
+const path = require("path");
+const pkg = require("../package.json");
 
 const banner = `\x1b[33m
 ┌──────────────────────────────────────────────────────────────────────────────┐
-│  ⭐ T-ZERO CONTEXT ARCHITECT & MCP ENGINE v10.7.0                            │
+│  ⭐ T-ZERO CONTEXT ARCHITECT & MCP ENGINE v${pkg.version}                            │
 │                                                                              │
 │  Hi! I'm Toprak Ahmet Aydoğmuş, a 15-year-old developer from Siber Akademi. │
 │  I built T-Zero from scratch to eliminate token bloat and AI hallucinations. │
 │                                                                              │
-│  If this tool saves you tokens, please give us a ⭐ on GitHub:              │
+│  If this tool saves you tokens, please give our project a STAR on GitHub:    │
 │  👉 https://github.com/toprakahmetaydogmus/TZeroAlgorithm                    │
+│                                                                              │
+│  Every star means the world to a young open-source creator! 🚀 Thank you!    │
 └──────────────────────────────────────────────────────────────────────────────┘
 \x1b[0m`;
 
@@ -45,25 +49,16 @@ if (!py) {
   process.exit(1);
 }
 
-// Ensure tzero_v3 module is installed in this python environment
-try {
-  execSync(`${py} -c "import tzero_v3"`, { stdio: "ignore" });
-} catch (e) {
-  if (process.stdout.isTTY) {
-    console.log("\x1b[36m[T-Zero] First-time setup: installing tzero-mcp from PyPI...\x1b[0m");
-  }
-  try {
-    execSync(`${py} -m pip install -U tzero-mcp`, { stdio: "inherit" });
-  } catch (err) {
-    console.error("\x1b[31m[ERROR] Failed to auto-install tzero-mcp. Please run: pip install -U tzero-mcp\x1b[0m");
-    process.exit(1);
-  }
-}
+const srcDir = path.resolve(__dirname, "..", "src");
+const scriptPath = path.join(srcDir, "tzero_v3.py");
 
-const args = ["-m", "tzero_v3", ...process.argv.slice(2)];
-const child = spawn(py, args, { stdio: "inherit" });
+const env = Object.assign({}, process.env, {
+  PYTHONPATH: srcDir + (process.env.PYTHONPATH ? path.delimiter + process.env.PYTHONPATH : "")
+});
+
+const args = [scriptPath, ...process.argv.slice(2)];
+const child = spawn(py, args, { stdio: "inherit", env });
 
 child.on("close", (code) => {
   process.exit(code ?? 0);
 });
-

package/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * T-Zero Model Context Protocol (MCP) Server & AST Context Architect
+ * Author: Toprak Ahmet Aydoğmuş (Siber Akademi)
+ * Repository: https://github.com/toprakahmetaydogmus/TZeroAlgorithm
+ */
+
+export interface TZeroPackageInfo {
+  version: string;
+  author: string;
+  repository: string;
+  srcDir: string;
+  mcpServer: string;
+  cli: string;
+}
+
+export declare const version: string;
+export declare const author: string;
+export declare const repository: string;
+export declare const srcDir: string;
+export declare const mcpServer: string;
+export declare const cli: string;
+
+declare const tzero: TZeroPackageInfo;
+export default tzero;

package/index.js

@@ -1,11 +1,15 @@
+const path = require("path");
+
 /**
  * T-Zero Context Architect & MCP Server
  * https://github.com/toprakahmetaydogmus/TZeroAlgorithm
  */
 
 module.exports = {
-  version: "10.7.0",
+  version: "10.7.2",
   author: "Toprak Ahmet Aydoğmuş (Siber Akademi)",
-  repository: "https://github.com/toprakahmetaydogmus/TZeroAlgorithm"
+  repository: "https://github.com/toprakahmetaydogmus/TZeroAlgorithm",
+  srcDir: path.resolve(__dirname, "src"),
+  mcpServer: path.resolve(__dirname, "src", "tzero_mcp.py"),
+  cli: path.resolve(__dirname, "src", "tzero_v3.py")
 };
-

package/package.json

@@ -1,12 +1,28 @@
 {
   "name": "tzero-mcp",
-  "version": "10.7.0",
+  "version": "10.7.2",
   "description": "Deterministic AST Context Compressor, 95% Token Reducer & 20-Tool MCP Server for Cursor, Claude Desktop & Copilot.",
   "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "files": [
     "bin",
+    "src",
     "index.js",
+    "index.d.ts",
     "README.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
     "LICENSE",
     "package.json"
   ],
@@ -15,11 +31,17 @@
     "tzero-mcp": "bin/tzero-mcp.js"
   },
   "scripts": {
+    "postinstall": "node bin/postinstall.js",
     "test": "node bin/tzero.js --version"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/toprakahmetaydogmus/TZeroAlgorithm.git"
+    "url": "git+https://github.com/toprakahmetaydogmus/TZeroAlgorithm.git",
+    "directory": "installers/npm"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/toprakahmetaydogmus/TZeroAlgorithm"
   },
   "keywords": [
     "mcp",