README

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.

About Univeros

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.

Sub-packages

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 agents

The 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.

Repositories

univeros/univeros — composer create-project starter and the main entry point for application developers.
univeros/framework — this repo. The library source.
univeros/docs — per-package documentation.

Contributing

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 only

CI mirrors the same gates plus the determinism drift check.

Security

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.

License

Univeros is open-sourced software licensed under the MIT license.

univeros / framework

Maintainers

Package info

Statistics

Security

README

About Univeros

Sub-packages

Repositories

Contributing

Security

License