The source code of the Univeros framework. Namespace: Altair\*. Ships as composer require univeros/framework.
Note: this repository contains the core code of Univeros. If you want to build an application using Univeros, visit the main univeros/univeros repository.
Univeros is a PHP 8.3+ framework for building APIs. Its codebase lives under the Altair\* namespace — the engineering name, the way Illuminate\* is the engineering name for Laravel's components. The brand consumers see is Univeros; Altair\* is the plumbing.
It looks familiar at first — PSR-7/15 HTTP stack, a DI container, a Cycle ORM bridge, a Symfony Messenger bridge, immutable value objects, single-pass middleware. The unusual part is the layer above that: a CLI surface (bin/altair) whose every command emits deterministic JSON an AI agent can branch on, and a set of primitives — spec-driven scaffolding, a rewindable journal, an append-only event log, a symbol-usage index, a doctor, a refactor adviser, an MCP server — designed so an agent can be productive without a human in the loop.
For the pitch, agent affordances walkthrough, and architecture diagram, see univeros/univeros. For per-package guides, see univeros/docs.
The framework is composed of 36 standalone PHP packages under src/Altair/. Each is published as a read-only repository at github.com/univeros/<name>. Pull the whole framework via:
composer require univeros/framework…or compose individual packages:
composer require univeros/http # PSR-7 + PSR-15 stack, single-pass middleware
composer require univeros/scaffold # YAML spec → Action/Input/Responder + OpenAPI + tests
composer require univeros/persistence # Repository/UnitOfWork bridge over Cycle ORM v2
composer require univeros/messaging # MessageBus bridge over Symfony Messenger
composer require univeros/events # Append-only mutation event log for agentsThe complete published list: agent-spec, bootstrap, cache, cli, common, configuration, container, cookie, courier, data, doctor, eval, events, examples, filesystem, happen, http, index, introspection, mcp, messaging, middleware, migration-intelligence, observability, observatory, persistence, profiling, sanitation, scaffold, security, session, structure, suggest, test-reporter, tinker, validation.
Splits are produced automatically by .github/workflows/split.yml — see docs/packages/split-publish.md for the operator runbook. All changes belong in this monorepo; the split repos are read-only mirrors.
- univeros/univeros —
composer create-projectstarter and the main entry point for application developers. - univeros/framework — this repo. The library source.
- univeros/docs — per-package documentation.
Issues and pull requests are welcome on this repository — it's the source of truth. The 35 sub-package repos under github.com/univeros/* are read-only mirrors; PRs against them will be ignored and overwritten on the next split.
Before submitting:
composer qa # cs + stan + test — the pre-commit gate
composer test # PHPUnit 11 onlyCI mirrors the same gates plus the determinism drift check.
If you discover a security vulnerability, please report it privately via GitHub Security Advisories instead of opening a public issue. We will respond and coordinate disclosure from there.
Univeros is open-sourced software licensed under the MIT license.