Sentinel: Enterprise Micro-Frontend Contract Guard

Sentinel is a specialized infrastructure tool designed to solve "dependency hell" and runtime collisions in distributed Micro-Frontend (MFE) architectures using Webpack Module Federation.

🚀 Current Status: v0.1.0-alpha (MVP)

The core CLI engine is operational, focusing on preventative auditing of shared dependency contracts.

Core Features Implemented:

• Version Comparison Engine: Robust SemVer-based validation for singleton shared dependencies. Detects Major/Minor/Patch conflicts before deployment.
• CLI Auditor: Integrated scan and check commands that can be used locally or within CI/CD pipelines.
• Manifest Generation: Automatically parses module-federation.config.js and package.json to create a SentinelManifest.
• CI/CD Guardrails: Returns exit code 1 on critical version conflicts to block unstable deployments.
• Strict Typing: Full internal contract definitions (SentinelManifest, ValidationConflict, etc.) ensuring high reliability.

🗺 Roadmap & Vision

We are scaling Sentinel from a local CLI tool to a global governance platform.

Phase 2: Observability & Pro Integration (Upcoming)

• AST Parsing: Deep analysis of remoteEntry.js and webpack.config.js for automated interface validation.
• Vite Support: Extending contract guarding to the Vite ecosystem.
• Interface Guarding: Validation of exposed modules vs. consumed remotes.

Phase 3: Enterprise Governance (Grant Focus)

• Dependency Graph Database: Implementation of a Neo4j-based global state resolution engine.
• Fetch State API: Real-time simulation of production deployments against current cluster states.
• Observability Agent: Browser-based monitoring of runtime federation health and collision tracking.

Phase 4: AI-Powered Semantic Analysis (Active R&D)

• LLM-Driven Validation: Using state-of-the-art, high-context AI models to analyze AST diffs and predict runtime crashes that standard SemVer misses.
• Automated Conflict Resolution: Generating intelligent codemods to auto-fix version mismatches across multiple repositories.

🛠 Tech Stack

• Language: TypeScript
• Backend (Planned): Node.js / ClickHouse (Audit Logs)
• Database (Planned): Neo4j (Dependency Graph)
• AI Engine (Planned): Enterprise-grade LLM APIs (e.g., Azure OpenAI, Google Vertex AI, Anthropic)
• Infrastructure: Cloud-Agnostic / Major Cloud Providers (AWS / Azure / GCP)

---

📄 Documentation

For a deep dive into the architecture, graph database schema, and complete AI integration roadmap, please see the full Technical Specification.

---

Contact: founder@sentinel-hq.io