Engineering Single Source of Truth (ESSOT)
Govern Your Engineering With Intelligence. The unified architecture synthesis, SSOT governance, and autonomous repair platform for human engineers and AI coding agents.
+-----------------------------------------------------------------------------------------+
| ESSOT Web Application |
| +--------------------------+ +--------------------------+ +-----------------------+ |
| | Architecture Studio | | SSOT & AST Graph View | | Forge Engine Studio | |
| | (8-Artifact Synthesis) | | (Single Source of Truth) | | (Autonomous Repair) | |
| +--------------------------+ +--------------------------+ +-----------------------+ |
+--------------------------------------------+--------------------------------------------+
| REST API / WebSockets / FastMCP
+--------------------------------------------v--------------------------------------------+
| FastAPI Core Backend |
| - 8-Artifact Synthesis Pipeline (SRD, TechEval, ADR, Spec, UML, C4, Security, STQE) |
| - 1-Click SSOT Bridge & Markdown/YAML Serializer (ssot.zip) |
| - OpenRouter PKCE AI Gateway & High-Entropy Secret Redactor |
| - AST Knowledge Graph Indexer & Bounded Repair Planner |
| - Cryptographic Approval Gate (plan_hash & commit snapshot drift check) |
+--------------------------------------------+--------------------------------------------+
| Subprocess Execution
+--------------------------------------------v--------------------------------------------+
| Deterministic Worker Sandbox (ADR-005) |
| - Git Snapshot Restoration |
| - AST Syntax & Import Tree Validation |
| - Isolated Subprocess Test Verification (pytest / npm test) |
| - Instant Automatic Rollback on Failure |
+-----------------------------------------------------------------------------------------+Architecture Design & Synthesis Engine
Transforms informal software intent, functional requirements, and system constraints into an authoritative, production-grade 8-artifact architecture package before a single line of code is written.
Core Functional Capabilities:
- Socratic Elicitation Chat: Dialogue with an autonomous AI Requirements Engineer to explore throughput targets, database tradeoffs, and compliance constraints.
- Autonomous 8-Artifact Synthesis: Generates SRD (with Gherkin acceptance criteria), TechEval, ADRs, TechSpec (DDL & API contracts), UML models, C4 diagrams, Security assessments, and STQE test specifications.
- Visual Inspector & Pan-Zoom: Interactive Mermaid viewer for class, sequence, state, and C4 models with targeted single-artifact regeneration.
- 1-Click SSOT Bridge & Markdown Serializer: Converts artifacts into compliant Markdown and YAML frontmatter, updates the AST property graph, and exports a ready-to-commit ssot.zip bundle.
SSOT Knowledge Base & AST Semantic Graph
Creates, maintains, versions, and queries the authoritative engineering knowledge repository stored directly in your repository alongside source code.
Core Functional Capabilities:
- Authoritative ssot/ Directory: Standardized, machine-readable specifications committed to Git alongside source code with complete version provenance.
- AST Property Graph: Indexes classes, interfaces, method signatures, and imports to trace relationships across specifications and code (IMPLEMENTS, DEPENDS_ON, CALLS).
- Knowledge Validation & Health Score: Detects contradictions, requirement/ADR conflicts, and architectural violations, computing a 0–100 Knowledge Health Score.
- Semantic Search & Impact Analysis: Answers complex architectural queries like "What breaks if UserService changes?" with reasoning explanations and direct artifact citations.
ESSOT Forge Engine & Autonomous Repair
Continuously detects drift between live code and active specifications, synthesizes targeted repair plans, and executes deterministic test suites within an isolated sandbox.
Core Functional Capabilities:
- Continuous Drift Detection: Identifies discrepancies between Git modifications and active SRD/ADR contracts.
- Bounded Evidence Assembler: Packages minimal AST slices and relevant ADR citations while scrubbing high-entropy API keys and secrets.
- Cryptographic Human Gate: A SHA-256 plan_hash binds the repair plan to the exact commit snapshot; stale commits trigger immediate aborts.
- Deterministic Subprocess Verification (ADR-005): Executes real test suites (pytest, npm test) in isolated worker subprocesses with zero stochastic self-evaluation and automatic rollback on failure.
- Tamper-Evident Audit Ledger: Chronological, immutable records of all drift findings, plans, cryptographic signatures, diffs, and test results.
Agent Orchestration & FastMCP Tools
Orchestrates role-specialized AI coding agents and connects cloud governance directly into local developer IDEs via the Model Context Protocol (FastMCP).
Core Functional Capabilities:
- Role-Specialized AI Agents: Instantiates Developer (symbol grounded), Architecture (ADR grounded), Testing (STQE grounded), and Security (threat matrix grounded) agents.
- Official essot Skill: Equips Google Antigravity, Claude Code, Cursor, and Windsurf with a 3-step synchronization protocol (Update Local SSOT -> Synchronize with Web App -> Generate Audit Report).
- Local FastMCP Server (essot-mcp-server): Connects essot.space directly to local IDE workspaces via secure tunnels (ngrok http 8123 with /trigger webhook).
- OpenRouter PKCE AI Gateway: Seamless AI provider authentication with dynamic multi-model routing and automated high-entropy secret redaction.
The 5-Minute ESSOT Synchronization Protocol
Equip your development workflow and autonomous AI coding agents with verifiable architectural grounding in four straightforward steps.
Synthesize 8 Artifacts
Engage with the conversational Requirements Engineer to autonomously generate your complete architecture package.
1-Click Git Commit
Click 'Move to SSOT' to download the ready-to-commit ssot.zip bundle directly into your repository.
Ready to Govern Your Engineering With Intelligence?
Launch ESSOT directly in your browser or contact our solutions engineering team for air-gapped enterprise integrations.
