Metadata-Version: 2.4
Name: verel
Version: 0.0.1
Summary: The agent framework where nothing is done until a grader returns a verdict — verification + grounded perception (AgentVision eyes). Reserved; under active design.
Project-URL: Homepage, https://github.com/amitpatole/verel
Project-URL: Source, https://github.com/amitpatole/verel
Author-email: Amit Patole <amit.patole@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,agentvision,ai-agents,evals,llm,memory,orchestration,verification
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Verel

> The agent framework where nothing is **"done"** until a grader returns a verdict —
> checked by real senses including **eyes** ([AgentVision](../Eyes_For_AI_Agents)) —
> and only verified work is allowed to compound into the fleet's shared memory.

## Documents

- **[docs/VEREL_DESIGN.md](docs/VEREL_DESIGN.md)** — definitive architecture & build plan
  (positioning, the moat, the five organs, the Brain/memory architecture, the Fleet,
  the Verdict bus, AgentVision-as-eyes, claimable inventions, risks, phased roadmap,
  open decisions).
- **[docs/CRITIC_CONVERGENCE.md](docs/CRITIC_CONVERGENCE.md)** — the adversarial critic-loop
  score record that the design was iterated against until diminishing returns.

## The five organs

```
Brain (memory)  ─┐
Fleet (agents managing agents) ─┤
Verdict bus (eval-driven everything) ─┼─► nothing merges on a self-asserted "done"
Senses (AgentVision eyes + logs/tests/metrics) ─┤
Tool-smith (agent-built tooling) ─┘
```

## Smallest first useful thing (Phase 0, ~2–4 weeks)

Unified `Report`/`Percept` schema + `gate()` + scrubbed-fingerprint `progressed()`,
wired to the AgentVision `sight` adapter over MCP, driving a single-worker ultracode loop
on one real repo's UI. **Done = Verel fixes a real UI overflow and the loop terminates on
a `pass` verdict it computed itself.** No memory, no fleet, no consolidation yet.
