Repository navigation
Release Notes: ctxfw v4.1.0 / v4.1.1 — Enterprise FinOps, Zero-Config AST Compaction & CI/CD Gate
ctxfw (Context Firewall by Heurístico Lab) is an independently audited (Glama.ai Grade A 100/100), air-gapped Layer-0 AST context compactor and Anthropic Model Context Protocol (MCP) security boundary for autonomous coding agents (Claude Code, Cursor, Windsurf, Aider, Copilot).
- Canonical Benchmarks & Docker Reproducibility (
SHA-256 Attested): https://ctxfw.heuristicolab.com/benchmarks/ (Raw Markdown) - Architectural Comparison vs. Check Point, Palo Alto Prisma AIRS, Zenity & Cloud WAFs: https://ctxfw.heuristicolab.com/compare/ (Raw Markdown)
- Independent Third-Party Security & Quality Audits:
- Glama.ai MCP Directory (Certified Grade A — 100/100 Security, License & Quality): https://glama.ai/mcp/servers/heuristicolab/ctxfw
- SkillsDirectory Security Audit (Certified Grade A — 100/100): https://www.skillsdirectory.com/authors/heuristicolab
- Public PyPI & GitHub Telemetry: 9,671+ total PyPI downloads (
2,175+directwithout_mirrors) · 538+ git clones across 153 unique developer environments (https://pypi.org/project/ctxfw/)
Progressive Two-Mode Adoption (Zero Adoption Friction)
-
Mode 1 — Zero-Config Fast Track (
< 60 seconds, Zero Formal Specifications Required):
You do not need to writeSPEC.axioms.mdor formal invariants to usectxfw. Runningpip install --upgrade ctxfw && ctxfw install --claude(orctxfw mcp) immediately activates -72.4% to -74.4% Tree-sitter AST token compaction ($D_0 \to D_3$ , with 100% byte-for-byte focal file preservation underAXIOM-3) and 0.33 ms P50SARAindirect prompt injection quarantine out of the box. -
Mode 2 — Optional Sovereign Axiomatic Gateway (
ACI >= 0.9000):
For critical production paths (SQL DDL, billing, authentication), squads can optionally enableevaluate_spec_axiomsandctxfw gatein CI/CD using ready-to-use drop-in templates from https://heuristicolab.com/vault.
Independently Reproducible A/B Benchmarks (/benchmarks/)
| Target Repository | Archetype | Active Focal |
Raw Graph Tokens | Compacted Bundle | Token Savings | Warm P95 Latency | AST Pass Rate |
|---|---|---|---|---|---|---|---|
zulip/zulip (2,037 files) |
Coupled Django Monolith | zerver/models/users.py |
328,379 |
84,049 ( |
-74.40% ( |
9.45 ms | 100% PASS |
apache/airflow (8,348 files) |
Async Orchestration | airflow/models/dag.py |
454,364 |
137,599 ( |
-69.72% ( |
14.66 ms (437k tok/s) | 100% PASS |
PostHog/posthog (24,261 files) |
Analytics Data OS | posthog/models/team/team.py |
1,379,115 |
698,864 ( |
-49.32% ( |
59.54 ms | 100% PASS |
heuristicolab/ctxfw (16 deps) |
MCP Security Gateway | src/ctxfw/cli.py |
49,096 |
20,014 ( |
-59.50% Net (-72.4% Interface Stubs) | < 0.80 ms | 100% PASS |
What's New in v4.1.0 / v4.1.1
1. LiveBench 2.0 FinOps Model Matrix & 4.2x Multi-Turn Economics (ctxfw.finops)
- Frontier Model Matrix (
model_matrix.json): Native cost & LiveBench coding score comparison across Claude Opus 4.6, Claude Sonnet 4.6, GPT-5, o3, Gemini 2.5 Pro, and DeepSeek V3.2. - 4.2x Multi-Turn Compounding Calculator: Quantifies 15-turn stateful coding session savings factoring prompt cache writes (
1.25x), cache reads (0.10x), and TTL invalidation pauses. - Tamper-Evident Squad Consolidation (
ctxfw report --team-merge): Aggregates distributed.jsonltelemetry ledgers across engineering squads with SHA-256 line-level attestation.
2. Deterministic CI/CD Pull Request Gate & Composite GitHub Action (ctxfw gate)
- Autonomous PR Gate (
ctxfw gate): Evaluates unified git diffs (--diff/--base) in< 1.0 msagainst cyclomatic complexity bounds, banned imports, and# type: ignoresuppressions, emitting native GitHub Step Summaries (--github-summary). - Official Composite GitHub Action (
action.yml): Drop-inuses: heuristicolab/ctxfw@v4integration for GitHub Actions workflows with zero external cloud dependencies.
3. Sovereign Offline RSA-2048 Licensing (ctxfw license) & Vault Capsules
-
Zero-Callout Cryptographic Verification: Open-Core B2B governance (
TEAM$199/moat ctxfw.heuristicolab.com/pricing/,ENTERPRISE) verified 100% locally via RSA-2048 PKCS#1 v1.5 signatures (CTXFW-LIC-v1.<payload>.<sig>), alongside perpetual$290 USDOne-Shot Zero-Dependency Capsules (MCP-08,SARA-01,SWE-03) at heuristicolab.com/vault.
4. Reproducible 24-Vector OWASP AISVS (C02-01) & arXiv:2510.05244v2 Benchmark
- 100.0% Recall (16/16 Adversarial Blocked) / 0.0% False Positive Rate (0/8 Benign): Open-source executable harness (
benchmarks/run_sara_security_benchmark.py, SHA-256 digestb691dd2824e9c654336f02f350e66ecbbd3ad2fd5ca114528b16b2f5f36f575b) running in0.33 msP50 /1.72 msP95 latency with0bytes of network egress. - Layer-0 Complement to Check Point, Palo Alto Prisma AIRS & Zenity: Resolves the OWASP DevSecOps Guideline
2-2-5 AI-Agent-and-MCP-Securityand Official MCP Security Best Practices pain points locally over JSON-RPC 2.0stdiobefore context ever reaches cloud WAFs (Full Comparison).
Verification, Upgrade & Support
# 1. Install or upgrade via PyPI (Zero-Config Mode 1 works immediately)
pip install --upgrade ctxfw
ctxfw doctor # Verdict: [HEALTHY] [ATTESTED]
# 2. Execute reproducible 24-vector OWASP AISVS SARA security benchmark
python benchmarks/run_sara_security_benchmark.py --json
# 3. Support the open-core standard from your terminal (GitHub CLI)
gh repo star heuristicolab/ctxfw