Skip to content

ctxfw v4.1.0 — Enterprise FinOps, Asymmetric Licensing & CI/CD Gate

Choose a tag to compare

@heuristicolab heuristicolab released this 22 Oct 21:32
· 23 commits to main since this release

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).


Progressive Two-Mode Adoption (Zero Adoption Friction)

  1. Mode 1 — Zero-Config Fast Track (< 60 seconds, Zero Formal Specifications Required):
    You do not need to write SPEC.axioms.md or formal invariants to use ctxfw. Running pip install --upgrade ctxfw && ctxfw install --claude (or ctxfw 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 under AXIOM-3) and 0.33 ms P50 SARA indirect prompt injection quarantine out of the box.
  2. Mode 2 — Optional Sovereign Axiomatic Gateway (ACI >= 0.9000):
    For critical production paths (SQL DDL, billing, authentication), squads can optionally enable evaluate_spec_axioms and ctxfw gate in 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 $D_0$ (100% Intact) 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 ($D_3$) -74.40% ($D_3$) / -78.20% ($D_1$) 9.45 ms 100% PASS
apache/airflow (8,348 files) Async Orchestration airflow/models/dag.py 454,364 137,599 ($D_3$) -69.72% ($D_3$) / -90.26% ($D_1$) 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 ($D_3$) -49.32% ($D_3$) / -59.53% ($D_1$) 59.54 ms 100% PASS
heuristicolab/ctxfw (16 deps) MCP Security Gateway src/ctxfw/cli.py 49,096 20,014 ($D_1+D_2$) -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 .jsonl telemetry 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 ms against cyclomatic complexity bounds, banned imports, and # type: ignore suppressions, emitting native GitHub Step Summaries (--github-summary).
  • Official Composite GitHub Action (action.yml): Drop-in uses: heuristicolab/ctxfw@v4 integration 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/mo at ctxfw.heuristicolab.com/pricing/, ENTERPRISE) verified 100% locally via RSA-2048 PKCS#1 v1.5 signatures (CTXFW-LIC-v1.<payload>.<sig>), alongside perpetual $290 USD One-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 digest b691dd2824e9c654336f02f350e66ecbbd3ad2fd5ca114528b16b2f5f36f575b) running in 0.33 ms P50 / 1.72 ms P95 latency with 0 bytes 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-Security and Official MCP Security Best Practices pain points locally over JSON-RPC 2.0 stdio before 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