morphism 0.1.0

Categorical governance engine — morphisms, functors, natural transformations

Morphism

Self-healing intelligence layer for AI agent fleets. Mathematical governance with category-theoretic foundations, drift detection, and autonomous correction.

Entropy is the default. Governance is the override.

Why Morphism

• Mathematical guarantees — 7 kernel invariants and 10 operational tenets, grounded in category theory
• Self-healing — Automatic drift detection and context re-normalization without human intervention
• Compound learning — Every agent interaction improves the fleet through proof state logging
• Installable — MCP servers, CLI, and npm packages for integration into existing workflows

Quick Start

TypeScript (Next.js app + packages)

npm install
npx turbo dev        # Start development
npx turbo build      # Build all packages
npx turbo test       # Run tests

Python (Governance engine + CLI)

pip install -e ".[dev]"
morphism --help      # CLI usage
pytest tests/        # Run tests

MCP Server (Claude, Cursor, etc.)

{
  "mcpServers": {
    "morphism-math": {
      "command": "npx",
      "args": ["@morphism-systems/agentic-math"]
    }
  }
}

Architecture

graph TD
    A[morphism.systems] --> B[apps/morphism — Next.js 15]
    A --> C[packages/shared — @morphism-systems/shared]
    A --> D[packages/agentic-math — MCP Server]
    A --> E[packages/cli — CLI]
    A --> F[src/morphism — Python Core]
    F --> G[engine/ — Category Theory]
    F --> H[metrics/ — κ, δ]
    F --> I[cli/ — Governance CLI]

Layer	Stack	Purpose
Web	Next.js 15, Turborepo	SaaS dashboard
Shared	TypeScript, Zod	Types, schemas, utilities
MCP	TypeScript, MCP SDK	AI tool integration
Python	Click, Category Theory	Governance engine, metrics
Scripts	Python	CI validation, maturity scoring

Governance

The governance framework is the core of Morphism. See AGENTS.md for the full specification.

Document	Purpose
AGENTS.md	Root governance rules
SSOT.md	Single source of truth
Kernel	7 invariants (I-1..I-7)
Docs Index	Full documentation map

Contributing

See CONTRIBUTING.md for development setup, architecture overview, and contribution guidelines.

License

MIT