Skip to main content

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

Project description

forge health

Your AI agent doesn't know what you meant to build. Forge compiles your architectural intent into a verified, queryable graph — so your agents work with structure, not guesswork.

The Solution

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

The Demo

Forge managing itself (forge):

{
  "graph_health": 100,
  "sync_health": 100,
  "infra_health": 100,
  "adi_score": 0,
  "brc_score": 100,
  "idr_score": 100,
  "overall": 100,
  "healthy": true
}

Quickstart

git clone https://github.com/[your-username]/forge
cd forge && pip install -e .
forge start --project-path ~/Projects/my-app

How It Works

Three primitives: node, edge, event.

The Protocol Layer

  • GloveProtocol — source analysis for any stack
  • CheckerProtocol — infrastructure health checking
  • RendererProtocol — graph output formatting
  • SubscriberProtocol — event bus subscription

The Metrics

  • ADI — Architectural Debt Index from ghost nodes, dark matter, stale annotations
  • BRC — Blast Radius Coverage percentage of nodes with edge connectivity
  • IDR — Intent Decay Rate of nodes lacking recent annotations
  • POS — Predictive Obsolescence Score from implementation status and age
  • HealthVector — unified six-dimensional health vector

Status

Current epoch: 6 (External Surface) Test count: 1005+ Roadmap: https://github.com/[your-username]/forge/issues

Planning and handoff notes live in _context/. Root docs/ may lag; treat _context as the primary narrative for this repo.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eforge-1.0.0-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

Details for the file eforge-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: eforge-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.0

File hashes

Hashes for eforge-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d10871ef34e2ddcc7d1443b64bee7b5c1a18aae299a6e4c52f26883be23b8cae
MD5 63b286f715a180213ee4c6f7b66daf25
BLAKE2b-256 2458deb07bb702a502051b798981292421d075ba604593c3c86aa10f9fb1d814

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page