Open Source • Apache-2.0
MCPNative Model Context Protocol
v1.1.1Node 22+ Native Engine

Engineering standards for AI coding agents.

Universal cross-agent framework delivering architectural governance, empirical verification, living context graphs, and quality gates to Cursor, Antigravity, Claude Code, & Copilot.

Interactive Studio
10 Skills Canonical Architecture
Native MCP Protocol Tools
5 Vectors Verification Gate
Zero Assumed Success
sagarithm-cliv1.1.1
$npx sagarithm-kit context stats
⚙ Parsing project AST & topological dependency graph...
Afferent Coupling (Ca)
14incoming
Efferent Coupling (Ce)
3outgoing
Martin Instability Metric (I):0.18 (Highly Stable)
Orphan Abstractions:0 detected (Clean)
Active Preset: systems-coreNode.js 22+ Native ESM
npm

npm & npx Registry

GLOBAL CLI RUNTIME

Live public release v1.1.1

npx sagarithm-kit init
MCP

Model Context Protocol

STDIO JSON-RPC 2.0

Antigravity • Claude • Cursor

sagarithm mcp
AI

Multi-Agent Adapters

6 TARGET RUNTIMES

Compiler & zero drift

sagarithm sync --target all
GH

GitHub Packages

CONTAINER & NPM REGISTRY

Scoped enterprise package

npm i @sagarithm/sagarithm-kit
[ 01 / 05 ]Interactive Studio

Compile cross-agent configurations in real-time.

Select an agent target and architectural preset to observe deterministic instruction compilation, policy constraints, and empirical quality gates.

sagarithm-compiler|Deterministic AST Engine
100% Client-Side Simulation
Real-Time Compiler

Canonical laws compile deterministically into native targets on selection with zero manual drift.

Target:.cursorrules
Active Presetsystems-core
Quality Gate[VERIFIED]
Graph Cycles0 (Acyclic DAG)
<!-- SAGARITHM:START -->
# SAGARITHM ENGINEERING CONSTITUTION (Target: .cursorrules)
# Preset: systems-core | Version: 1.1.1

## Supreme Behavioral Governors
- Zero Assumed Success: You are strictly forbidden from declaring a task complete without empirical test evidence.
- Entropy Security Gate: Shannon entropy H >= 4.5 triggers an immediate security abort.
- Acyclic Graph Constraint: Circular dependencies between modules are considered critical bugs.

## Active Preset Directives (systems-core)
- 1. Never create circular dependencies; all modules must form a strict DAG.
- 2. Shannon entropy threshold for credentials is H >= 4.5. Secrets must never be committed.
- 3. Zero Assumed Success: Verify code using empirical test execution before reporting done.
- 4. No generic 'utils' or 'helpers' directories; use domain-oriented taxonomy.

## Required Verification Vectors
1. Static Analysis: Strict typing, zero eslint warnings.
2. Security Gate: Zero hardcoded API keys, tokens, or private secrets.
3. Architecture Fitness: Acyclic DAG topology, zero 'utils/helpers' anti-patterns.
4. Behavioral Tests: All unit and integration test assertions green.
5. Documentation: Topology manifest and ADR state synchronized.
<!-- SAGARITHM:END -->
[ 02 / 05 ]Core Capabilities

Built for autonomy, architecture, and security.

Embedding architectural governance, native MCP tools, entropy token defense, and topological graph analysis directly into the agentic development loop.

01/engine.ts
State Machine Automation

Autonomous Workflow Orchestration

Deterministic multi-stage workflow runner executing feature development, bug fixes, refactoring, and release prep with strict gate enforcement.

CLI Command:sagarithm run feature-development
02/server.ts
JSON-RPC 2.0 Protocol

Native Model Context Protocol (MCP)

Zero-dependency JSON-RPC 2.0 stdio server exposing 6 architectural tools directly to Antigravity, Claude Code, and Cursor for live verification.

CLI Command:sagarithm mcp
03/validate.ts
No Blind Compliance

Truth-Driven Idea Validation

Senior Principal Architect stress-test forbidding blind AI compliance. Surfaces operational bottlenecks, state model risks, and defines strict non-goals.

CLI Command:sagarithm validate "<idea>"
04/secrets.ts
Information Entropy H >= 4.5

Algorithmic Shannon Entropy Scanner

Detects high-randomness tokens and API credentials at H >= 4.5 Shannon entropy, stopping confidential leaks and injection flaws before commits occur.

CLI Command:sagarithm audit --strict
05/graph.ts
Afferent/Efferent Metric Graph

Robert C. Martin Instability & Coupling

Calculates Afferent (Ca) and Efferent (Ce) coupling metrics, calculates component instability I = Ce / (Ca + Ce), and isolates unreferenced orphan abstractions.

CLI Command:sagarithm context stats
06/health.ts
100-Point Quality Radar

Composite Codebase Health Index

100-point repository health score across structural hygiene, modularity, dead code, secrets, and test density for automated CI/CD quality gating.

CLI Command:sagarithm health
[ 03 / 05 ]System Architecture

Six decoupled layers. One source of truth.

Decoupled engineering principles, skills, and policies compiled deterministically into native agent targets without configuration drift.

Layer 01

Engineering Constitution

constitution/

Role & Purpose

Codified principles governing engineering philosophies, strict typing, error handling, testing pyramids, OWASP security, documentation standards, atomic git hygiene, and SemVer releases.

Codified Specifications in Layer 01

01-engineering-principles.md
02-architecture-principles.md
03-coding-standards.md
04-testing-principles.md
05-security-principles.md
06-documentation-standards.md
07-git-standards.md
08-release-standards.md
Decoupled Design:100% Target Agent Agnostic
[ 04 / 05 ]Verification Benchmark

Standard prompts assume. Sagarithm Kit verifies.

Evaluating software engineering reliability across raw LLM prompting, static .agents rules, and Sagarithm Kit's empirical multi-vector quality gates.

Engineering DimensionRaw LLM Prompting.agentsSagarithm Kit v1.1.1
Proof of Correctness Gate
Self-reported 'Task Completed' (No test run)
Static markdown instructions (Easily ignored)
Zero Assumed Success (Mandatory empirical test execution)
Credential Leak Defense
None (High risk of pushing live keys)
Naive regex strings (Misses random tokens)
Shannon Entropy H >= 4.5 + Regex Pattern Engine
Architectural Graph Governance
Creates circular dependency cycles
No AST or graph awareness
Acyclic DAG Cycle Interception & Martin Instability (I)
Code Organization & Anti-Patterns
Dumps code into 'utils' & 'helpers' drawers
Subjective guidelines
Automated Fitness Audit & Refactoring Remediation (--fix)
Cross-Agent Ecosystem Sync
Completely manual prompt re-entry
Hardcoded to a single IDE file (.cursorrules)
Universal AST Compiler (Cursor, Antigravity, Claude, Copilot)
Orphan Abstraction Interceptor
Leaves dead code and unreferenced exports
None
AST Export/Import graph isolates unreferenced interfaces
Model Context Protocol (MCP)
None (Manual copy-pasting)
Static markdown files only
Native JSON-RPC 2.0 stdio MCP Server (6 live verification tools)
Idea Validation & Truth-Telling
Blind compliance ('Sure, I will build that!')
Unstructured brainstorming prompts
Senior truth-teller: Surfaces bottlenecks, non-goals, and invariants
Methodology: Multi-vector execution harnessZero Assumed Success Principle
[ 05 / 05 ]CLI & Quickstart

One install. Governs every agent.

Run natively with npx, install globally via npm, or integrate directly into your CI/CD pipeline to enforce Zero Assumed Success on every pull request.

Initialize Sagarithm Kit workspace configuration

Generates the canonical sagarithm.config.json file, detects existing agent configurations, and prepares workspace directories.

$npx sagarithm-kit init
BASH / POWERSHELL

Command Flags & Options

--forceOverwrite existing configurations without confirmation
--preset <id>Initialize with a curated preset (fullstack-web, systems-core, etc.)

Simulated Output

✔ Generated sagarithm.config.json
✔ Detected target: .cursorrules (Cursor IDE)
✔ Successfully initialized Sagarithm Kit in workspace!