eforge 1.0.1

Renderer-agnostic project runtime and manifest interpreter for the Forge ecosystem

Quickstart

# Initialize a project
forge init

# Understand your project
forge orient

# Find undeclared files
forge discover

# Check structural health
forge verify

# Inspect a node
forge inspect <node_id>

What it does

eforge maintains a declaration graph of your codebase: every module, screen, controller, service, and component — declared, typed, and connected. When you change something, forge tells you what breaks, what it affects, and why.

forge orient --project-path ~/Projects/my-app

  ✦ eforge orient — my-app

  stack    : flutter-app
  phase    : 1
  health   : ✓ clean
  nodes    : 297
  domains  : AUTH, CANVAS, CORE, GAME, LOBBY (+4)

  Health scores:
    ADI  100%  implementation coverage
    BRC  100%  blast radius coverage
    IDR   14%  intent declaration rate

  Next:
    forge discover   — find undeclared files
    forge verify     — check structural parity
    forge inspect <node> — inspect a node

Works with your AI tools

eforge runs as an MCP server, giving Claude and Cursor direct access to your project graph:

forge mcp

Add to your MCP config and your AI agent can call:

• forge_orient — understand the project
• forge_inspect — inspect any node
• forge_blast_radius — see what a change affects
• forge_verify — check structural health
• forge_annotate — add architectural notes

Multi-stack

eforge understands Flutter, Python, Astro, React, and TypeScript projects out of the box. Stack-specific behavior is handled by gloves — pluggable parsers that translate your stack into forge primitives.

Health scores

Score	Meaning
ADI	Implementation coverage — declared nodes with real paths
BRC	Blast radius coverage — nodes with edge connectivity
IDR	Intent declaration rate — nodes with purpose documented

Requirements

• Python 3.12+
• Works with any codebase

License

MIT ENDOFREADME

git add README.md git commit -m "docs: rewrite README — accurate install, quickstart, orient demo, MCP section" git push origin main