Veritas

Veritas is a repo-local framework and CLI for trustworthy AI-assisted development. It lets your codebase define its own map, rules, and proof lanes — so AI-generated changes come with structured evidence instead of blind faith. Works with any AI agent. No runtime dependencies beyond Node.

Quickstart

npm install -D @kontourai/veritas
npx veritas init
npx veritas shadow run --working-tree

That bootstraps your repo with an adapter, policy pack, and team profile, then runs the first shadow check.

What You Get

• Repo Map — a typed graph of your codebase so AI knows what it's touching
• Rules — staged policies: invariants, preferences, and temporary rails
• Evidence — a bounded artifact of what changed, what was proven, what passed
• Feedback — live eval records that measure whether guidance actually helped

Documentation

• Full Documentation
• Getting Started
• Concepts Overview
• CLI Reference

Repository Layout

• bin/ — CLI entrypoints
• src/ — framework logic
• schemas/ — JSON schemas
• docs/ — guides, design, reference
• tests/ — smoke tests

Contributing

See CONTRIBUTING.md.

License

Apache-2.0