ausus/starter

AUSUS V0 starter template — boots a working HelloInvoice demo on top of kernel + persistence-sql + runtime-default. Installs via `composer create-project ausus/starter myapp`.

Maintainers

Package info

github.com/adonko3xBitters/starter

Homepage

Type:project

pkg:composer/ausus/starter

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.0 2026-05-19 10:17 UTC

This package is auto-updated.

Last update: 2026-05-20 02:04:39 UTC


README

Project template that boots a working AUSUS application end-to-end.

Quickstart (post-Packagist publication)

composer create-project ausus/starter myapp
cd myapp && composer boot
# expected: "OK — ausus/starter boots cleanly."

Quickstart (clean-room / pre-Packagist publication)

If ausus/* packages are not yet on Packagist, point Composer at a local artifact registry (a directory of composer archive .tar outputs):

AUSUS_LOCAL_REGISTRY=/path/to/registry \
  composer create-project ausus/starter myapp \
    --no-install \
    --repository='{"type":"artifact","url":"/path/to/registry"}' \
    --repository='{"packagist.org":false}'

cd myapp
composer install
composer boot

The --no-install flag tells create-project to skip its cascading dependency resolution; the starter's post-root-package-install hook (bin/configure-repo.php) reads AUSUS_LOCAL_REGISTRY and writes a repositories field into myapp/composer.json. The subsequent composer install resolves all ausus/* deps from the artifact registry.

Total wall time on a 2025-era machine: < 0.5 s of composer CPU, 0 LOC authored by the consumer.

What gets installed

Package Role
ausus/kernel metadata graph, value objects, DSL facade (L0)
ausus/persistence-sql SQLite/MySQL/Postgres PersistenceDriver (L3)
ausus/runtime-default Invoker, Policy Engine, Workflow runtime (L2)

What's in the project after composer create-project

myapp/
├── bin/
│   ├── boot.php              # end-to-end smoke (exit 0 if vendor/ missing)
│   └── configure-repo.php    # clean-room artifact-repo configurator
├── src/
│   ├── HelloInvoice.php      # demo Plugin (manual descriptor-array form)
│   └── HelloInvoiceDsl.php   # same demo, written in the RFC-011 DSL
├── composer.json
└── README.md

RFC ownership

  • RFC-012 §12 — starter project template
  • RFC-011 §2.1 — DSL plugin worked example (HelloInvoiceDsl.php)