PerfectDocRoot™ for Developers

The PerfectDocRoot API is now available in developer preview.

PerfectDocRoot is governance infrastructure for AI workflows. Instead of wiring raw prompt output directly into your application, you run governed executions with validation, artifacts, and provenance built in.

  • Governed runs instead of opaque prompt responses
  • Contract-aware validation and repair-ready execution flow
  • Artifacts, execution steps, and provenance for every run
  • Operator inspection through the local admin console

→ View the PerfectDocRoot API on GitHub

Start Here: 60-Second Demo

The fastest way to understand PerfectDocRoot is to run the API locally. 

cd app
npm install
npm start

Then open: 

http://127.0.0.1:3000/admin/runs

You will immediately see a governed execution run, including:

  • input payload
  • validation report
  • execution steps
  • result
  • provenance hashes
  • generated artifacts

This is the fastest way to see the PerfectDocRoot governed execution model in action.

What PerfectDocRoot Adds

Most AI integrations still operate as prompt in, response out. PerfectDocRoot adds a governance layer between your application and AI execution.

A governed run moves through a more reliable lifecycle: 

Input Payload
→ Contract Validation
→ Execution
→ Provenance Recording
→ Artifact Generation

This makes downstream automation more stable and gives developers a clearer inspection trail for what happened during execution.

What You Can Inspect

PerfectDocRoot records the workflow evidence around each run, not just the final output.

  • run lifecycle
  • validation results
  • execution steps
  • artifacts
  • provenance records

This is what makes PDR different from a thin prompt wrapper. The run itself becomes inspectable.

Repository Structure

The repository is organized so developers can understand both the runtime and the governed execution model quickly. 

perfectdocroot/
├── app/                     # core runtime
├── examples/                # developer examples
│   └── pdr-minimal-example
├── contracts/               # contract schema examples
├── docs/                    # architecture documentation
└── scripts/                 # development utilities

If you are new to the repo, begin with: 

examples/pdr-minimal-example

Project Status

PerfectDocRoot API is currently in developer preview.

The current runtime already demonstrates:

  • governed run lifecycle
  • artifact storage
  • execution worker engine
  • contract resolution
  • operator admin console

The current focus is developer adoption and ecosystem growth.

How the Platform Evolves

PerfectDocRoot is developing in three layers: 

Layer 1 — PDR Runtime (Open Source)
Layer 2 — Developer Ecosystem
Layer 3 — PDR Cloud Platform

The GitHub repository is the launch point for Layer 1. This site is where Layer 2 grows through documentation, domain-pack direction, and developer ecosystem updates.

Where to Go Next

Explore the open-source runtime:

→ PerfectDocRoot API on GitHub

Explore the live demonstration layer:

→ Governed Content Creation

Read how the workflow works:

→ PDR Governance Guide