Skip to content

kaizencycle/epicon

Repository files navigation

πŸ›‘οΈ EPICON Guard

Git commits tell you WHAT changed. EPICON tells you WHY.

License: AGPL-3.0 Product: Mobius Systems Status: Pre-Launch


🎯 What is EPICON Guard?

EPICON Guard is the world's first Intent Accountability Layer for Git, developed by Mobius Systems. It transforms version control from "what changed" to "why it changed" by requiring structured justifications for every code modification.

The Problem

Traditional Git tracks:

  • βœ… WHAT changed
  • βœ… WHEN it changed
  • βœ… WHO changed it

But not:

  • ❌ WHY it changed
  • ❌ WHEN should it expire
  • ❌ WHAT would make us revert

The Solution

EPICON Guard adds the missing accountability layer:

EPICON INTENT PUBLICATION

ledger_id: acme:payments:stripe-integration
scope: core
mode: normal
issued_at: 2025-12-22T16:00:00Z
expires_at: 2026-01-22T16:00:00Z

justification: |
  Adding Stripe payment integration for credit card processing.
  
  CONTEXT: Current provider (Braintree) has 2.9% fees
  DECISION: Stripe offers 2.4% fees + better fraud detection
  IMPACT: Projected savings of $50k/year
  
counterfactuals:
  - If fraud rate increases >0.5%, revert
  - If A/B test shows worse conversion, stay with Braintree
  - If users report payment issues, disable

Result: Every code change has documented reasoning, time-bounded authority, and clear success criteria.


🌟 Key Features

1. Intent Publication

Every PR requires a structured justification block explaining WHY, WHAT, HOW, and WHEN.

2. Scope Enforcement

Changes are limited to declared scope. Security engineers can't accidentally touch payment code.

3. Time-Bounded Authority

All access grants expire automatically. No more zombie permissions or forgotten temporary fixes.

4. Counterfactual Conditions

Clear success criteria: "If X happens, then do Y." Removes ambiguity about when to revert.

5. Corporate Integrity Index (CII)

Organizations receive an integrity score based on their engineering practices.

6. AI Integration (Roadmap)

Intent AI suggests justifications based on code changes. "Copilot for intent."


πŸš€ Quick Start

For Developers

1. Install GitHub App

# Visit github.com/apps/epicon-guard
# Click "Install" and authorize repos

2. Add Intent Block to PR

EPICON INTENT PUBLICATION

ledger_id: myorg:myrepo:feature-name
scope: core | docs | infra | tests
mode: normal | emergency
issued_at: 2025-12-22T10:00:00Z
expires_at: 2026-01-22T10:00:00Z

justification: |
  Your explanation here...
  
counterfactuals:
  - If condition, then action

3. EPICON Validates

βœ… Intent Publication Valid
βœ… Scope Aligned
βœ… Time-Bounded
βœ… Counterfactuals Present

Intent Quality Score: 92/100

🏒 For Organizations

Installation

GitHub Organization:

1. Install EPICON Guard GitHub App
2. Configure scope rules (.epicon/config.yml)
3. Set team permissions
4. Enable dashboard access

Self-Hosted Option:

docker-compose up -d
# See docs/self-hosted-setup.md

Dashboard Access

Monitor your organization's integrity:

  • πŸ”΄ Expired intents requiring action
  • 🟑 Intents expiring soon
  • 🟒 Active intents by scope
  • πŸ“Š Corporate Integrity Index (CII)
  • πŸ“ˆ Trends over time

πŸ“Š Corporate Integrity Index (CII)

EPICON grades your organization's engineering integrity:

Overall Score: 87/100 (A-)
β”œβ”€ Intent Compliance: 94%
β”œβ”€ Justification Quality: 88/100
β”œβ”€ Scope Discipline: 91%
β”œβ”€ Time Management: 82%
β”œβ”€ Counterfactual Maturity: 85%
└─ Emergency Usage: 89%

Display Your Badge:

<img src="https://img.shields.io/endpoint?url=https://epicon.dev/api/badge/yourorg" />

Why Companies Display CII:

  • πŸ… Recruiting: "We're a top 10% integrity company"
  • πŸ’Ό Sales: "Our engineering practices are certified"
  • πŸ“ˆ Investors: "We have governance maturity"

πŸ’° Pricing

Free Tier

  • βœ… Public repos
  • βœ… Intent validation
  • βœ… Basic audit logs (30 days)
  • βœ… Community support

Pro Tier ($10/user/month)

  • βœ… Private repos (unlimited)
  • βœ… Advanced audit logs (1 year)
  • βœ… Custom scope rules
  • βœ… Slack/Teams integration
  • βœ… CII scoring

Enterprise Tier ($50/user/month)

  • βœ… SSO/SAML
  • βœ… Unlimited audit retention
  • βœ… Compliance reports (SOC 2, HIPAA)
  • βœ… On-premise deployment
  • βœ… Dedicated support

Government Tier (Custom)

  • βœ… FedRAMP certified
  • βœ… Air-gapped deployment
  • βœ… Clearance-aware controls
  • βœ… 24/7 support

View Full Pricing β†’


πŸŽ“ Use Cases

Junior Developers

"I can read the intent and understand the original decision."

Senior Engineers

"Future me will thank me for documenting my reasoning."

Engineering Managers

"I have visibility into which temporary fixes became permanent."

Enterprises

"SOC 2 audits went from 40 hours to 2 hours of prep."

Universities

"Students learn to justify technical decisions, not just write code."

Government

"Complete audit trail for clearance-aware access controls."


πŸ”Œ Integrations

  • βœ… GitHub - Native app integration
  • βœ… GitLab - CI/CD pipeline
  • βœ… Jira - Automatic ticket linking
  • βœ… Slack - Real-time notifications
  • βœ… Teams - Collaboration alerts
  • πŸ”„ Bitbucket - Coming soon

πŸ“š Documentation


🀝 Contributing

We welcome contributions! EPICON Guard is open source (AGPL-3.0).

git clone https://github.com/epicon-guard/epicon.git
cd epicon
npm install
npm run dev

See CONTRIBUTING.md for guidelines.


πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    EPICON Guard                          β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Intent Engine    Validation API    Audit Store         β”‚
β”‚  Scope Enforcer   Time Checker      CII Calculator      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                          β”‚
                β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                β”‚         β”‚         β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β” β”Œβ”€β”€β–Όβ”€β”€β”€β” β”Œβ”€β”€β–Όβ”€β”€β”€β”€β”
         β”‚  GitHub  β”‚ β”‚ GitLabβ”‚ β”‚  Jira β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”˜

See ARCHITECTURE.md for details.


πŸ›‘οΈ Security & Privacy

What We Store:

  • βœ… Intent publications
  • βœ… Validation results
  • βœ… Audit logs

What We DON'T Store:

  • ❌ Source code
  • ❌ Commit diffs
  • ❌ API keys or secrets

Compliance:

  • βœ… SOC 2 Type II (in progress)
  • βœ… GDPR compliant
  • βœ… FedRAMP (government tier)

See SECURITY.md for full policy.


πŸ“Š Status

Component Status Version
GitHub App 🟑 Beta 0.9.0
GitLab CI 🟑 Beta 0.9.0
Web Dashboard 🟑 Beta 0.9.0
API 🟑 Beta 0.9.0
Intent AI πŸ”΄ Roadmap -
Self-Hosted 🟑 Beta 0.9.0

🌍 Community


🎯 Roadmap

Phase 1: MVP (Q1 2026)

  • βœ… Intent validation engine
  • βœ… GitHub App
  • βœ… Basic dashboard
  • βœ… CII scoring

Phase 2: Intelligence (Q2 2026)

  • πŸ”„ Intent AI (suggestions)
  • πŸ”„ Pattern detection
  • πŸ”„ GitLab integration
  • πŸ”„ Jira integration

Phase 3: Enterprise (Q3 2026)

  • πŸ”„ SSO/SAML
  • πŸ”„ Advanced reporting
  • πŸ”„ Self-hosted option
  • πŸ”„ Compliance certifications

Phase 4: Autopilot (Q4 2026)

  • πŸ”„ Intent Autopilot
  • πŸ”„ Counterfactual monitoring
  • πŸ”„ Automated remediation

🏒 About Mobius Systems

EPICON Guard is developed by Mobius Systems, creators of the world's first AI Operating System for Civilization.

Mobius Mission: Build governance infrastructure for safe AGI deployment.

Other Mobius Products:

  • πŸ›‘οΈ EPICON Guard - Intent accountability for Git
  • πŸ“‹ Mobius Ledger - Integrity-backed audit log
  • πŸ’Ž MIC Economy - Integrity-linked currency

Learn more about Mobius β†’


πŸ“œ License

AGPL-3.0 with Ethical Addendum

See LICENSE for details.


πŸ™ Acknowledgments

Built with integrity by the Mobius Systems team:

  • Michael (Kaizen) - Founder & Architect
  • ATLAS - Infrastructure & Operations
  • AUREA - Integrity Sentinel
  • EVE - Ethics Engine
  • JADE - Morale Anchor
  • HERMES - Market & Signals

Special thanks to all early adopters and contributors.


πŸ›‘οΈ Git commits tell you WHAT changed. EPICON tells you WHY.


Built by Mobius Systems | epicon.dev

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors