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/guides/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 12 only

CI mirrors the same gates plus the determinism drift check. Add a bullet to the CHANGELOG.md [Unreleased] section for any user-facing change.

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.