{"id":50342662,"url":"https://github.com/profrandom92/comptext-revolution","last_synced_at":"2026-05-29T18:00:44.440Z","repository":{"id":354606829,"uuid":"1223410781","full_name":"ProfRandom92/comptext-revolution","owner":"ProfRandom92","description":"🚀 CompText Revolution — token-efficient DSL kernel for LLM agents. DSL compiler + MCP server + SQLite FTS5 index + session memory + sandbox runner in one unified system.","archived":false,"fork":false,"pushed_at":"2026-04-29T09:27:13.000Z","size":550,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T10:13:10.316Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ProfRandom92.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T09:48:14.000Z","updated_at":"2026-04-29T09:27:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ProfRandom92/comptext-revolution","commit_stats":null,"previous_names":["profrandom92/comptext-revolution"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ProfRandom92/comptext-revolution","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProfRandom92%2Fcomptext-revolution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProfRandom92%2Fcomptext-revolution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProfRandom92%2Fcomptext-revolution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProfRandom92%2Fcomptext-revolution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ProfRandom92","download_url":"https://codeload.github.com/ProfRandom92/comptext-revolution/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProfRandom92%2Fcomptext-revolution/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33664259,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-29T18:00:42.788Z","updated_at":"2026-05-29T18:00:44.433Z","avatar_url":"https://github.com/ProfRandom92.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n```\n ██████╗ ██████╗ ███╗   ███╗██████╗ ████████╗███████╗██╗  ██╗████████╗\n██╔════╝██╔═══██╗████╗ ████║██╔══██╗╚══██╔══╝██╔════╝╚██╗██╔╝╚══██╔══╝\n██║     ██║   ██║██╔████╔██║██████╔╝   ██║   █████╗   ╚███╔╝    ██║   \n██║     ██║   ██║██║╚██╔╝██║██╔═══╝    ██║   ██╔══╝   ██╔██╗    ██║   \n╚██████╗╚██████╔╝██║ ╚═╝ ██║██║        ██║   ███████╗██╔╝ ██╗   ██║   \n ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝        ╚═╝   ╚══════╝╚═╝  ╚═╝   ╚═╝  \n                                                                        \n██████╗ ███████╗██╗   ██╗ ██████╗ ██╗     ██╗   ██╗████████╗██╗ ██████╗ ███╗   ██╗\n██╔══██╗██╔════╝██║   ██║██╔═══██╗██║     ██║   ██║╚══██╔══╝██║██╔═══██╗████╗  ██║\n██████╔╝█████╗  ██║   ██║██║   ██║██║     ██║   ██║   ██║   ██║██║   ██║██╔██╗ ██║\n██╔══██╗██╔══╝  ╚██╗ ██╔╝██║   ██║██║     ██║   ██║   ██║   ██║██║   ██║██║╚██╗██║\n██║  ██║███████╗ ╚████╔╝ ╚██████╔╝███████╗╚██████╔╝   ██║   ██║╚██████╔╝██║ ╚████║\n╚═╝  ╚═╝╚══════╝  ╚═══╝   ╚═════╝ ╚══════╝ ╚═════╝    ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝\n```\n\n### The Universal Token Compression Platform for LLMs\n*Compress smarter. Remember more. Spend less.*\n\n\u003cbr/\u003e\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)](https://www.python.org/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-009688?style=for-the-badge\u0026logo=fastapi\u0026logoColor=white)](https://fastapi.tiangolo.com/)\n[![Kubernetes](https://img.shields.io/badge/Kubernetes-Ready-326CE5?style=for-the-badge\u0026logo=kubernetes\u0026logoColor=white)](./k8s/)\n[![MCP](https://img.shields.io/badge/MCP-15%20Tools-FF6B35?style=for-the-badge)](https://modelcontextprotocol.io/)\n[![Tests](https://img.shields.io/badge/Tests-84%20Passing-22C55E?style=for-the-badge)](https://vitest.dev/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-F59E0B?style=for-the-badge)](LICENSE)\n\n\u003cbr/\u003e\n\n```\n┌─────────────────────────────────────────────────────────────────────────────┐\n│  \"Please provide comprehensive documentation for all function parameters\"   │\n│                              ↓  CompText L5                                 │\n│              \"prvd docs fn params\"      →      58% fewer tokens             │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n\u003c/div\u003e\n\n---\n\n## Table of Contents\n\n- [Why CompText?](#-why-comptext)\n- [Architecture](#-architecture)\n- [KVTC Compression Engine](#-kvtc-compression-engine)\n- [MCP Tools](#-mcp-tools-15-total)\n- [Memory Palace](#-memory-palace)\n- [Quick Start](#-quick-start)\n- [Monorepo Structure](#-monorepo-structure)\n- [Python REST API](#-python-rest-api)\n- [Test Suite](#-test-suite)\n- [Kubernetes Deployment](#-kubernetes-deployment)\n- [Performance](#-performance)\n\n---\n\n## ⚡ Why CompText?\n\nEvery token costs money. Every token wastes latency. CompText solves both.\n\n```\n┌──────────────────────────────────────────────────────────────────────────┐\n│                         TOKEN COST REALITY                               │\n│                                                                          │\n│  Raw prompt:      ████████████████████████████████  1,200 tokens  $0.018│\n│  CompText L2:     █████████████████████             750 tokens    $0.011│\n│  CompText L5:     ████████████                      430 tokens    $0.006│\n│                                                                          │\n│  At 10,000 daily requests  →  save $120/day  →  $43,800/year            │\n└──────────────────────────────────────────────────────────────────────────┘\n```\n\n**CompText Revolution** is a production-grade, dual-stack platform (TypeScript + Python) that:\n\n- **Compresses** any text through 5 progressive levels (whitespace → skeleton)\n- **Remembers** context in a hierarchical `[[Palace:Wing:Room]]` memory system\n- **Indexes** documents into SQLite FTS5 with BM25 semantic ranking\n- **Exposes** 15 MCP tools to Claude Desktop with Python-first routing + TypeScript fallback\n- **Scales** to Kubernetes with Canary rollout, Prometheus metrics, and GitOps\n\n---\n\n## 🏗 Architecture\n\n```\n╔═══════════════════════════════════════════════════════════════════════════╗\n║                         COMPTEXT REVOLUTION                               ║\n║                                                                           ║\n║  ┌─────────────────┐                                                      ║\n║  │  Claude Desktop │ ◄──────── MCP Protocol (stdio JSON-RPC)             ║\n║  └─────────────────┘                   │                                  ║\n║                                        │                                  ║\n║  ┌─────────────────────────────────────▼───────────────────────────────┐  ║\n║  │                      MCP SERVER  (TypeScript)                        │  ║\n║  │                                                                       │  ║\n║  │   ┌──────────────────┐    ┌──────────────────┐                       │  ║\n║  │   │   Tool Handler   │───►│  Python Bridge   │ ──► HTTP :8000        │  ║\n║  │   │   (15 tools)     │    │  (HTTP client)   │                       │  ║\n║  │   └──────────────────┘    └──────────────────┘                       │  ║\n║  │            │                                                           │  ║\n║  │            └──► TypeScript Fallback Engine  (offline mode)            │  ║\n║  └────────────────────────────────────────────────────────────────────┘  ║\n║                                      │ HTTP/REST                          ║\n║  ┌───────────────────────────────────▼───────────────────────────────┐   ║\n║  │                    PYTHON BACKEND  (FastAPI)                        │   ║\n║  │                                                                      │   ║\n║  │   ┌──────────┐   ┌───────────┐   ┌──────────┐   ┌──────────────┐  │   ║\n║  │   │   KVTC   │   │ MemPalace │   │   CAS    │   │   Database   │  │   ║\n║  │   │ 5 levels │   │ [[P:W:R]] │   │  SHA-256 │   │ SQLite FTS5  │  │   ║\n║  │   └──────────┘   └───────────┘   └──────────┘   └──────────────┘  │   ║\n║  │                                                                      │   ║\n║  │   ┌────────────────────────────────────────────────────────────┐   │   ║\n║  │   │           Prometheus Metrics  ·  SafetyGate                │   │   ║\n║  │   └────────────────────────────────────────────────────────────┘   │   ║\n║  └──────────────────────────────────────────────────────────────────┘   ║\n║                                                                           ║\n║  ┌─────────────────────────────────────────────────────────────────────┐ ║\n║  │                 @comptext/core  (TypeScript · tsup)                  │ ║\n║  │   ┌────────────┐   ┌───────────────┐   ┌──────────────────────┐    │ ║\n║  │   │  Compiler  │   │ LLM Tokenizer │   │   Hybrid DSL Router  │    │ ║\n║  │   │ Levels 1-5 │   │  js-tiktoken  │   │ text/query/config/   │    │ ║\n║  │   └────────────┘   └───────────────┘   └──────────────────────┘    │ ║\n║  └─────────────────────────────────────────────────────────────────────┘ ║\n╚═══════════════════════════════════════════════════════════════════════════╝\n```\n\n---\n\n## 🧠 KVTC Compression Engine\n\n**Knowledge Vector Token Compression** — 5 progressive levels, each building on the last.\n\n```\nINPUT: \"This is basically a comprehensive documentation system for the configuration parameters.\"\n│\n├─ Level 1  Whitespace Normalization\n│           \"This is basically a comprehensive documentation system for the configuration parameters.\"\n│           Trims, collapses spaces, normalizes newlines\n│\n├─ Level 2  Filler Word Removal\n│           \"comprehensive documentation system configuration parameters.\"\n│           Removes: basically, actually, really, just, very, quite…\n│\n├─ Level 3  Article \u0026 Stop Word Removal\n│           \"comprehensive documentation system configuration parameters.\"\n│           Removes: a, an, the, and, for, of, in, to, with…\n│\n├─ Level 4  Abbreviation Substitution\n│           \"compr docs sys cfg params.\"\n│           Maps ~200 common words to short codes\n│\n└─ Level 5  Skeleton Compression  (most aggressive)\n            \"cmpr docs sys cfg prms.\"\n            Removes vowels from non-essential syllables\n```\n\n| Level | Name | Typical Reduction | Best For |\n|:-----:|------|:-----------------:|----------|\n| 1 | Normalize | ~5% | Always-on baseline |\n| 2 | Filler | ~15% | Casual conversation |\n| 3 | Articles | ~25% | Technical documentation |\n| 4 | Abbreviate | ~35% | Dense code / config |\n| 5 | Skeleton | ~45–55% | Maximum token savings |\n\n```python\nfrom ct_vault_core.kvtc import KVTCContextController\n\nkvtc = KVTCContextController()\nresult = kvtc.compress(\n    \"Please provide comprehensive documentation for all function parameters\",\n    level=5\n)\n# result.compressed  → \"prvd docs fn params\"\n# result.savings_pct → 58.3\n# result.tokens_in   → 12\n# result.tokens_out  → 5\n```\n\n---\n\n## 🔌 MCP Tools (15 Total)\n\nAll tools route to the Python backend first; TypeScript fallback activates automatically if Python is offline.\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                              TOOL MAP                                    │\n│                                                                          │\n│  COMPRESSION ────────────────────────────────────────────────────────   │\n│  ct_compress          Compress a document (level 1-5)                   │\n│  ct_compress_batch    Compress multiple docs in one call                │\n│  ct_encode            Encode to [CT:v1:Lx] DSL format with metadata    │\n│  ct_parse             Parse and extract CompText header + content       │\n│  ct_compress_output   Auto-escalate levels until token budget is met    │\n│                                                                          │\n│  MEMORY ─────────────────────────────────────────────────────────────   │\n│  mem_remember         Store content in [[Palace:Wing:Room:Drawer]]      │\n│  mem_recall           BM25 search across all memory locations           │\n│  mem_list             List all palace / wing / room locations           │\n│  mem_delete           Prune a specific memory location                  │\n│                                                                          │\n│  CONTEXT ────────────────────────────────────────────────────────────   │\n│  ctx_index            Index a document into SQLite FTS5                 │\n│  ctx_search           Full-text search with BM25 ranking                │\n│  ctx_checkpoint       Save current session state snapshot               │\n│                                                                          │\n│  STORAGE ────────────────────────────────────────────────────────────   │\n│  cas_store            Content-addressed store → returns SHA-256 hash    │\n│  cas_fetch            Retrieve blob by SHA-256 hash                     │\n│                                                                          │\n│  METRICS ────────────────────────────────────────────────────────────   │\n│  ct_token_stats       Global compression stats \u0026 savings report         │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n### Claude Desktop Integration\n\n```json\n// %APPDATA%\\Claude\\claude_desktop.json\n{\n  \"mcpServers\": {\n    \"comptext\": {\n      \"command\": \"node\",\n      \"args\": [\"C:/path/to/comptext-revolution/packages/mcp-server/dist/index.js\"],\n      \"env\": { \"PYTHON_BACKEND_URL\": \"http://localhost:8000\" }\n    }\n  }\n}\n```\n\n---\n\n## 🏛 Memory Palace\n\nHierarchical, persistent memory with LOCI-style spatial addressing.\n\n```\n[[Palace : Wing : Room : Drawer]]\n     │        │       │       └─ Optional fine-grained slot\n     │        │       └─ Specific topic within the wing\n     │        └─ Domain or category\n     └─ Top-level namespace\n\n[[math:algebra:equations]]           → all quadratic notes\n[[project:comptext:decisions]]       → architectural decisions  \n[[user:preferences:coding:style]]    → personal coding preferences\n[[research:papers:attention:notes]]  → annotation for a paper\n```\n\n```python\n# Store\nawait palace.remember(\"math\", \"algebra\", \"quadratic\",\n    \"x = (-b ± √(b²-4ac)) / 2a\")\n\n# BM25 semantic search\nresults = await palace.recall(\"quadratic formula\")\n# → [{\"location\": \"[[math:algebra:quadratic]]\", \"content\": \"...\"}]\n\n# List all locations in a palace\nlocations = palace.list_all(palace_filter=\"math\")\n\n# Delete a room\npalace.delete(\"math\", \"algebra\", \"quadratic\")\n```\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n```bash\nnode --version    # 18+\npnpm --version    # 9+\npython3 --version # 3.10+\n```\n\n### 1. Clone \u0026 Install\n\n```bash\ngit clone https://github.com/ProfRandom92/comptext-revolution.git\ncd comptext-revolution\npnpm install\n```\n\n### 2. Build TypeScript\n\n```bash\npnpm build\n# Builds all 7 packages via tsup (ESM + CJS + .d.ts)\n```\n\n### 3. Install Python Backend\n\n```bash\ncd packages-py\npip install -e \".[dev]\"\n```\n\n### 4. Start Services\n\n```bash\n# Terminal A — Python REST API (port 8000)\ncd packages-py\nuvicorn ct_vault_core.rest_api:app --host 0.0.0.0 --port 8000 --reload\n\n# Terminal B — MCP Server\nnode packages/mcp-server/dist/index.js\n```\n\n### 5. CLI\n\n```bash\n# Compress a file\npnpm cli compress ./my-doc.txt --level 3\n\n# Compress stdin\necho \"Hello world this is a verbose sentence\" | pnpm cli compress --level 5\n\n# Token savings report\npnpm cli stats\n```\n\n---\n\n## 📁 Monorepo Structure\n\n```\ncomptext-revolution/\n│\n├── packages/                          TypeScript (pnpm workspace)\n│   ├── core/                          @comptext/core\n│   │   ├── src/\n│   │   │   ├── compiler.ts            Levels 1-5 DSL compiler\n│   │   │   ├── levels.ts              applyLevel1..5 implementations\n│   │   │   ├── hybrid.ts              detectInputType + compressHybrid\n│   │   │   ├── llm-tokenizer.ts       js-tiktoken BPE counter\n│   │   │   ├── decompressor.ts        decompress + decompressLevel\n│   │   │   └── __tests__/             52 vitest tests\n│   │   └── package.json               tsup build, exports map\n│   │\n│   ├── indexer/                       SQLite FTS5 + BM25\n│   ├── session-memory/                Palace/Wing/Room snapshots\n│   ├── sandbox-runner/                Isolated Python/Bash execution\n│   ├── mcp-server/\n│   │   └── src/\n│   │       ├── tools.ts               15 tool definitions (JSON Schema)\n│   │       ├── tool-handler.ts        switch router → bridge or fallback\n│   │       └── python-bridge.ts       HTTP client to :8000\n│   └── sdk/                           Programmatic TypeScript API\n│\n├── packages-py/                       Python backend\n│   ├── ct_vault_core/\n│   │   ├── kvtc.py                    KVTCContextController (5 levels)\n│   │   ├── mem_palace.py              MemPalaceDB + LOCI addressing\n│   │   ├── cas.py                     ContentAddressedStore (SHA-256)\n│   │   ├── database.py                Async SQLite + FTS5\n│   │   ├── rest_api.py                FastAPI app (15 endpoints)\n│   │   └── safety_gate.py             Risk scoring + rate limiting\n│   └── tests/                         32 pytest tests\n│\n├── apps/cli/                          CLI application\n├── k8s/                               8 Kubernetes manifests\n├── docker-compose.yml                 Local dev orchestration\n├── Dockerfile.python                  Python backend image\n└── Dockerfile.mcp                     MCP server image\n```\n\n---\n\n## 🐍 Python REST API\n\nFastAPI backend on `http://localhost:8000`\n\n| Method | Endpoint | Description |\n|:------:|----------|-------------|\n| `POST` | `/compress` | Compress text at level 1-5 |\n| `POST` | `/remember` | Store in MemPalace |\n| `POST` | `/recall` | BM25 search in MemPalace |\n| `GET`  | `/mem/list` | List all memory locations |\n| `POST` | `/mem/delete` | Delete a memory location |\n| `POST` | `/cas/store` | Store blob, receive SHA-256 |\n| `GET`  | `/cas/{sha}` | Retrieve blob by hash |\n| `POST` | `/ctx/checkpoint` | Save session snapshot |\n| `POST` | `/encode` | Encode to `[CT:v1:Lx]` DSL |\n| `POST` | `/parse` | Parse CompText format |\n| `POST` | `/compress-output` | Auto-escalate to token budget |\n| `GET`  | `/token-stats` | Global compression metrics |\n| `GET`  | `/health` | Health check |\n| `GET`  | `/metrics` | Prometheus metrics |\n\n```bash\n# Compress at level 4\ncurl -s -X POST http://localhost:8000/compress \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"Please provide comprehensive documentation\", \"level\": 4}'\n# → {\"compressed\":\"prvd compr docs\",\"savings_pct\":45.2,\"tokens_in\":6,\"tokens_out\":3}\n\n# Interactive API docs\nopen http://localhost:8000/docs\n```\n\n---\n\n## 🧪 Test Suite\n\n**84 tests — all passing**\n\n```\n┌────────────────────────────────────────────────────────────────────┐\n│                                                                      │\n│  TypeScript  (vitest)                                  52 / 52  ✓  │\n│  ├─ compress.test.ts                     19 tests                  │\n│  ├─ compression.integration.test.ts      13 tests                  │\n│  ├─ hybrid.test.ts                       12 tests                  │\n│  └─ llm-tokenizer.test.ts                 8 tests                  │\n│                                                                      │\n│  Python  (pytest)                                      32 / 32  ✓  │\n│  ├─ test_kvtc.py                          6 tests                  │\n│  ├─ test_mem_palace.py                    8 tests                  │\n│  ├─ test_database.py                      5 tests                  │\n│  ├─ test_safety_gate.py                   5 tests                  │\n│  └─ test_integration.py                   8 tests                  │\n│                                                                      │\n└────────────────────────────────────────────────────────────────────┘\n```\n\n```bash\n# TypeScript\npnpm --filter @comptext/core test run\n\n# Python\ncd packages-py \u0026\u0026 python -m pytest tests/ -v\n\n# Both at once\npnpm test \u0026\u0026 cd packages-py \u0026\u0026 python -m pytest tests/ -q\n```\n\n---\n\n## ☸️ Kubernetes Deployment\n\nProduction-ready manifests with Canary rollout via Flagger.\n\n```\nk8s/\n├── namespace.yaml           comptext-revolution namespace\n├── deployment.yaml          MCP server  (3 replicas · HPA 3-10)\n├── deployment-python.yaml   Python backend  (3 replicas)\n├── service.yaml             ClusterIP services\n├── ingress.yaml             NGINX ingress + TLS\n├── hpa.yaml                 HorizontalPodAutoscaler\n├── pvc.yaml                 PersistentVolumeClaim (vault data)\n└── canary.yaml              Flagger Canary — 3-phase, 22 days\n```\n\n**Canary phases:**\n\n```\nPhase 1  (Days  1–7)   10% traffic  ──  latency p99 \u003c 200ms  ──►  pass\nPhase 2  (Days  8–15)  40% traffic  ──  error rate  \u003c 1%     ──►  pass\nPhase 3  (Days 16–22)  90% traffic  ──  all metrics green    ──►  promote\n```\n\n```bash\nkubectl apply -f k8s/\nkubectl get canary -n comptext-revolution -w\n```\n\n---\n\n## 📊 Performance\n\n```\n┌──────────────────────────────────────────────────────────────────────┐\n│                         BENCHMARK RESULTS                             │\n│                                                                        │\n│  Compression Latency                                                   │\n│  ├─ L1-L3       \u003c 1 ms    ████                                        │\n│  ├─ L4-L5       \u003c 5 ms    ████████                                    │\n│  └─ p99           8 ms    ████████████                                 │\n│                                                                        │\n│  Token Savings (typical prose)                                         │\n│  ├─ Level 2    15-20 %    ████████                                    │\n│  ├─ Level 3    20-30 %    ████████████                                 │\n│  ├─ Level 4    30-40 %    ████████████████                             │\n│  └─ Level 5    40-55 %    ████████████████████████                     │\n│                                                                        │\n│  Throughput                                                             │\n│  ├─ Compress API      5,000 req/s                                      │\n│  ├─ FTS5 index       10,000 docs/min                                   │\n│  └─ MemPalace recall    O(1) palace lookup                             │\n└──────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 🔗 Related\n\n| Repo | Role |\n|------|------|\n| [comptext-codex](https://github.com/ProfRandom92/comptext-codex) | Original Python compression foundation |\n| [comptext-mcp-server](https://github.com/ProfRandom92/comptext-mcp-server) | Original MCP integration |\n| [comptext-dsl](https://github.com/ProfRandom92/comptext-dsl) | DSL specification |\n\n\u003e This monorepo consolidates all three into a single production platform.\n\n---\n\n## 🤝 Contributing\n\nPRs, issues, and ideas welcome. The codebase is fully typed (TypeScript strict + Python type hints) and test-driven.\n\n```bash\npnpm install \u0026\u0026 pnpm build\ncd packages-py \u0026\u0026 pip install -e \".[dev]\"\n\n# Verify\npnpm --filter @comptext/core test run   # 52/52\ncd packages-py \u0026\u0026 python -m pytest      # 32/32\n```\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**MIT License © 2026 ProfRandom92**\n\n*Built with TypeScript · Python · FastAPI · SQLite · Kubernetes*\n\n\u003cbr/\u003e\n\n```\nEvery token counts.\nCompress the revolution.\n```\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofrandom92%2Fcomptext-revolution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprofrandom92%2Fcomptext-revolution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofrandom92%2Fcomptext-revolution/lists"}