- New rootless doos container runtime: sandbox, cgroup, network, images, hardening, davmount, CLI plus molo integration - 18 CVE audit reproductions with READMEs and Makefiles - Example DoosDemo routes, IndexCatalog, static assets, spec update - CLI serve on 0.0.0.0:8000, arg parser, dev server improvements - Runtime HTTP fixes, supervisor isolation backend - Tests for doos, example doos routes, CLI serve; suite count 261 to 265
Living example
Big living example project proving every MoloApp feature end to end.
Plan: plans/10-workflow-example.md, section 6.4.
Run it:
make -f example/example.mk example
./build/example/living-server 8000
The server listens on all interfaces. Open http://127.0.0.1:8000/ (or the
machine's LAN address) and click through the matrix; /stats has the
charts (Chart.js is embedded in the binary, no CDN). Narrow the
window to 360px: the top nav collapses into a dropdown menu.
Run the suite (205 route-level integration tests, real stack, no mocks):
make -f example/example.mk example-test
Load test (Locust, full integration)
example/locustfile.py hits literally every route: all GETs, all POSTs,
and the file PUTs, including the /routing/* prefix and parameterized
routes (/hello/{name}, /di/resolve/{name}, /tenancy/t/{tenant}/whoami,
/governance/keys/{id}/revoke, ...). Start the server, then:
pip install locust
locust -f example/locustfile.py --host http://127.0.0.1:8000
Open the Locust web UI at http://localhost:8089 (linked as locust in
the index matrix on /). Or headless:
make -f example/example.mk example-locust
The make target first runs the reproducible coverage gate
(example/check_locust_coverage.py), which enumerates every
add_feature index route plus every router registration, applies
fill/prefix normalization, and fails on gaps. Expected output:
routes=112 urls=176 methods=['get', 'options', 'post', 'put']
OK: 112/112 routes covered, methods ['get', 'options', 'post', 'put']
/ws/chat is exercised three ways: POST echo, HTTP upgrade-header
probe, and a true websocket roundtrip via ChatWebsocketUser
(websocket-client: open ws://host/ws/chat, send/recv, close).
Framework status
The framework is skeletal: example/fw/ holds a compiling skeleton of the
public API (request, response hierarchy, router, application, views,
validation, forms, negotiation, templates, middleware, DI-shaped services,
errors, cookies, static, TLS stub, KV, cache, pubsub, events, metrics,
telemetry, sessions, auth, ORM stub, uploads, WebDAV, supervisor, tasks,
replication, REST client, OpenAPI, AI harness sample, release pipeline,
test client, loopback server). Gaps are marked in example/SPEC.md and in
each header. As siblings 01 through 09 land, this app re-binds to the real
namespaces route by route; the URLs, tests, and matrix stay stable.
Coverage matrix
Feature -> route -> test file -> plan link. One row per feature; CI fails on a missing row.
| Feature | Route | Test file | Plan |
|---|---|---|---|
| index | / |
tests/example/index_test.cpp |
plans/10-workflow-example.md 6.4 |
| health probe | /health |
tests/example/health_test.cpp |
plans/09-cli-ops.md health |
| routing | /routing/hello/{name} |
tests/example/routing/hello_test.cpp |
plans/05-request-routing.md |
| class views | /routing/views/greet |
tests/example/routing/views_test.cpp |
plans/05-request-routing.md |
| routers | /routing/routers/nested/deep |
tests/example/routing/routers_test.cpp |
plans/05-request-routing.md |
| app chaining | /app1/app1/app1/whoami |
tests/example/chain/deep_test.cpp |
plans/05-request-routing.md |
| orm sqlite | /orm/users?backend=sqlite |
tests/example/orm/users_test.cpp |
plans/04-data.md |
| orm postgres | /orm/users?backend=postgres |
tests/example/orm/users_test.cpp |
plans/04-data.md |
| basic auth | /auth/me |
tests/example/auth/me_test.cpp |
plans/03-security.md |
| login | /auth/login |
tests/example/auth/login_test.cpp |
plans/03-security.md |
| sessions | /sessions/counter |
tests/example/sessions/counter_test.cpp |
plans/03-security.md |
| uploads | /uploads/file |
tests/example/uploads/file_test.cpp |
plans/03-security.md |
| forms | /forms/contact |
tests/example/forms/contact_test.cpp |
plans/05-request-routing.md |
| validation | /validate/user |
tests/example/validate/user_test.cpp |
plans/05-request-routing.md |
| templates | /templates/page |
tests/example/templates/page_test.cpp |
plans/05-request-routing.md |
| formats | /formats/data |
tests/example/formats/data_test.cpp |
plans/05-request-routing.md |
| static disk | /static/{name} |
tests/example/static/files_test.cpp |
plans/01-runtime.md |
| embedded | /embedded/{name} |
tests/example/embedded/assets_test.cpp |
plans/09-cli-ops.md |
| streaming | /streaming/feed |
tests/example/streaming/feed_test.cpp |
plans/06-realtime.md |
| passthrough | /streaming/passthrough |
tests/example/streaming/passthrough_test.cpp |
plans/06-realtime.md |
| websocket | /ws/chat |
tests/example/ws/chat_test.cpp |
plans/06-realtime.md |
| socket.io | /socketio/rooms |
tests/example/socketio/rooms_test.cpp |
plans/06-realtime.md |
| sse | /sse/events |
tests/example/sse/events_test.cpp |
plans/06-realtime.md |
| webdav | /webdav/files/ |
tests/example/webdav/files_test.cpp |
plans/06-realtime.md |
| pubsub | /pubsub/publish |
tests/example/pubsub/publish_test.cpp |
plans/04-data.md |
| events | /events/fire |
tests/example/events/fire_test.cpp |
plans/02-observability.md |
| metrics | /metrics/counters |
tests/example/metrics/counters_test.cpp |
plans/02-observability.md |
| telemetry | /telemetry/trace |
tests/example/telemetry/trace_test.cpp |
plans/02-observability.md |
| kv store | /kv/items |
tests/example/kv/items_test.cpp |
plans/04-data.md |
| cache | /cache/lookup |
tests/example/cache/lookup_test.cpp |
plans/04-data.md |
| tasks | /supervisor/tasks |
tests/example/supervisor/tasks_test.cpp |
plans/07-supervisor-replication.md |
| workers | /supervisor/workers |
tests/example/supervisor/workers_test.cpp |
plans/07-supervisor-replication.md |
| replication | /replication/state |
tests/example/replication/state_test.cpp |
plans/07-supervisor-replication.md |
| rest client | /restclient/self |
tests/example/restclient/self_test.cpp |
plans/08-clients-openapi.md |
| openapi | /openapi.json |
tests/example/openapi/docs_test.cpp |
plans/08-clients-openapi.md |
| docs page | /docs |
tests/example/openapi/docs_test.cpp |
plans/08-clients-openapi.md |
| ai harness | /cli/ai |
tests/example/cli/ai_test.cpp |
plans/09-cli-ops.md |
| workflow | /workflow/release |
tests/example/workflow/release_test.cpp |
plans/10-workflow-example.md 6.2 |
| redirects | /redirect/here |
tests/example/redirect/here_test.cpp |
plans/05-request-routing.md |
| statistics | /stats | tests/example/stats/page_test.cpp | plans/02-observability.md |
| statistics data | /stats/data | tests/example/stats/data_test.cpp | plans/02-observability.md |
| google status | /google/status | tests/example/google/status_test.cpp | src/google/SPEC.md |
| voice conversation page | /voice | tests/example/voice/page_test.cpp | src/google/SPEC.md |
| voice text to speech | /voice/say | tests/example/voice/say_test.cpp | src/google/SPEC.md |
| voice speech to text | /voice/hear | tests/example/voice/hear_test.cpp | src/google/SPEC.md |
| voice turn | /voice/turn | tests/example/voice/turn_test.cpp | src/google/SPEC.md |
| voice reset | /voice/reset | tests/example/voice/reset_test.cpp | src/google/SPEC.md |
| agent models | /agent/models | tests/example/agent/models/page_test.cpp | plans/16-agent-platform.md |
| agent runtime | /agent/runtime | tests/example/agent/runtime/page_test.cpp | plans/16-agent-platform.md |
| agent sessions and memory | /agent/sessions | tests/example/agent/sessions/page_test.cpp | plans/16-agent-platform.md |
| agent sandbox | /agent/sandbox | tests/example/agent/sandbox/page_test.cpp | plans/16-agent-platform.md |
| agent registry, gateway, identity | /agent/registry | tests/example/agent/registry/page_test.cpp | plans/16-agent-platform.md |
| agent armor and security | /agent/armor | tests/example/agent/armor/page_test.cpp | plans/16-agent-platform.md |
| agent evaluation and optimize | /agent/optimize | tests/example/agent/optimize/page_test.cpp | plans/16-agent-platform.md |
| agent development kit | /agent/adk | tests/example/agent/adk/page_test.cpp | plans/16-agent-platform.md |
| agent live streaming | /agent/live | tests/example/agent/live/page_test.cpp | plans/16-agent-platform.md |
| xai grok chat and tools | /ai/xai | tests/example/ai/xai/core/ | plans/17-llm-vendor-platforms.md |
| xai grok voice, collections, management | /ai/xai/platform | tests/example/ai/xai/platform/ | plans/17-llm-vendor-platforms.md |
| anthropic messages and tools | /ai/anthropic | tests/example/ai/anthropic/core/ | plans/17-llm-vendor-platforms.md |
| anthropic admin and agents | /ai/anthropic/admin | tests/example/ai/anthropic/admin/ | plans/17-llm-vendor-platforms.md |
| meta model api (muse spark) | /ai/meta | tests/example/ai/meta/ | plans/17-llm-vendor-platforms.md |
| deepseek | /ai/deepseek | tests/example/ai/deepseek/ | plans/17-llm-vendor-platforms.md |
| openai responses and media | /ai/openai | tests/example/ai/openai/core/ | plans/17-llm-vendor-platforms.md |
| openai platform services | /ai/openai/platform | tests/example/ai/openai/platform/ | plans/17-llm-vendor-platforms.md |
| openai organization admin | /ai/openai/admin | tests/example/ai/openai/admin/ | plans/17-llm-vendor-platforms.md |
| openrouter | /ai/openrouter | tests/example/ai/openrouter/ | plans/17-llm-vendor-platforms.md |
Extended features
Added in the second pass: security, platform, enterprise, resilience and
data-depth demos. Each row is a plain GET that answers 2xx; actions are
buttons or forms on the page. Per-module gaps versus src/ are in the
header of example/fw/{SecurityExtra,Platform,Enterprise,Resilience}.hpp.
tests/example/matrix_test.cpp crawls every row of the index.
| Feature | Route | Test file |
|---|---|---|
| CSRF token form | /security/csrf |
tests/example/security/csrf_test.cpp |
| CORS preflight allowlist | /security/cors |
tests/example/security/cors_test.cpp |
| Rate limiter (429 + Retry-After) | /security/rate |
tests/example/security/rate_test.cpp |
| Security headers | /security/headers |
tests/example/security/headers_test.cpp |
| CSP nonce page | /csp/page |
tests/example/csp/page_test.cpp |
| CSP report endpoint | /csp/report |
tests/example/csp/report_test.cpp |
| SHA-256 and HMAC | /crypto/hash |
tests/example/crypto/hash_test.cpp |
| Secure random token | /crypto/random |
tests/example/crypto/random_test.cpp |
| Password hashing (demo) | /crypto/password |
tests/example/crypto/password_test.cpp |
| Roles and permissions | /security/roles |
tests/example/security/ |
| Secrets provider (masked) | /security/secrets |
tests/example/security/secrets_test.cpp |
| Upload validation | /security/upload |
tests/example/security/upload_test.cpp |
| SQL and path guard | /security/guard |
tests/example/security/guard_test.cpp |
| Denial sink | /security/denials |
tests/example/security/denials_test.cpp |
| Login form with session cookie | /security/login |
tests/example/security/login_test.cpp |
| i18n | /i18n |
tests/example/i18n/ |
| gzip compression | /compress/demo |
tests/example/compress/demo_test.cpp |
| conditional GET and ranges | /conditional/doc |
tests/example/conditional/doc_test.cpp |
| liveness probe | /healthz |
tests/example/healthz/ |
| readiness probe | /readyz |
tests/example/readyz/ |
| startup gate | /startupz |
tests/example/startupz/ |
| prometheus metrics | /metrics |
tests/example/metrics/ |
| structured logging | /logging/records |
tests/example/logging/records_test.cpp |
| trace context | /context/trace |
tests/example/context/trace_test.cpp |
| DI container | /di/services |
tests/example/di/services_test.cpp |
| flash messages | /flash |
tests/example/flash/ |
| middleware builtins | /middleware/demo |
tests/example/middleware/demo_test.cpp |
| expose stats | /expose/stats |
tests/example/expose/stats_test.cpp |
| CLI commands | /cli/commands |
tests/example/cli/commands_test.cpp |
| Tenant resolution (header, subdomain, path) | /tenancy/resolve |
tests/example/tenancy/resolve_test.cpp |
| Tenant path resolution | /tenancy/t/demo/whoami |
tests/example/tenancy/ |
| Tenant data isolation | /tenancy/data |
tests/example/tenancy/data_test.cpp |
| Tenant quotas | /tenancy/quota |
tests/example/tenancy/quota_test.cpp |
| Tenant feature flags | /tenancy/flags |
tests/example/tenancy/flags_test.cpp |
| Tenant config overlay | /tenancy/config |
tests/example/tenancy/config_test.cpp |
| Per-tenant metrics | /tenancy/metrics |
tests/example/tenancy/metrics_test.cpp |
| Tenant provisioning form | /tenancy/provision |
tests/example/tenancy/provision_test.cpp |
| Hash-chained audit log | /audit/log |
tests/example/audit/log_test.cpp |
| Audit tamper detection | /audit/verify |
tests/example/audit/verify_test.cpp |
| PII masking and redaction | /audit/mask |
tests/example/audit/mask_test.cpp |
| Retention and legal hold | /audit/retention |
tests/example/audit/retention_test.cpp |
| Data subject export and erasure | /audit/subject |
tests/example/audit/subject_test.cpp |
| API keys with scopes | /governance/keys |
tests/example/governance/keys_test.cpp |
| Tiers and rate limit headers | /governance/tiers |
tests/example/governance/tiers_test.cpp |
| API versions (Deprecation, Sunset) | /v1/items |
tests/example/v1/items_test.cpp |
| API version list | /governance/versions |
tests/example/governance/versions_test.cpp |
| Route linter | /governance/lint |
tests/example/governance/lint_test.cpp |
| OpenAPI spec differ | /governance/diff |
tests/example/governance/diff_test.cpp |
| RFC 7807 problem+json | /governance/problem |
tests/example/governance/problem_test.cpp |
| Circuit breaker | /operability/breaker |
tests/example/operability/breaker_test.cpp |
| Bulkhead | /operability/bulkhead |
tests/example/operability/bulkhead_test.cpp |
| Load shedder | /operability/shedder |
tests/example/operability/shedder_test.cpp |
| Deadline propagation | /operability/deadline |
tests/example/operability/deadline_test.cpp |
| SLO error budget | /operability/slo |
tests/example/operability/slo_test.cpp |
| Chaos experiment | /operability/chaos |
tests/example/operability/chaos_test.cpp |
| Deploy strategies | /operability/deploy |
tests/example/operability/deploy_test.cpp |
| Lease, election, fenced lock | /operability/coord |
tests/example/operability/coord_test.cpp |
| Supply chain gate | /supplychain |
tests/example/supplychain/ |
| Client retry and backoff | /clients/retry |
tests/example/clients/retry_test.cpp |
| Client session: cookies, pool, proxy, auth | /clients/session |
tests/example/clients/session_test.cpp |
| Migrations: check then apply | /data/migrations |
tests/example/data/migrations_test.cpp |
| Transaction rollback | /data/transaction |
tests/example/data/transaction_test.cpp |
| Query builder and relations | /data/query |
tests/example/data/query_test.cpp |
| Singleflight | /data/singleflight |
tests/example/data/singleflight_test.cpp |
| TTL store, LRU, pubsub | /data/ttl |
tests/example/data/ttl_test.cpp |
| Debug snapshot | /operability/debug |
tests/example/operability/debug_test.cpp |
Layout
example/
example.mk # per-part make include (build, test, clean)
SPEC.md # mini-spec: behaviors, caps, formats, errors, gaps
README.md # this file
main.cpp # loopback server entry
fw/ # skeletal framework public API (namespace molo::example::fw)
app/ # demo routes (namespace molo::example::app)
static/ # disk static assets (responsive CSS, tiny JS)
assets/ # embedded at build time (Chart.js, stats.js, voice.js) via src/cli/embed
tools/ # build helper wrapping the embedder
tests/example/ # route-level integration tests mirroring URLs