- Rust 90.4%
- Python 9.3%
- Shell 0.2%
- PLpgSQL 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Amendment 6ad, rule 2: M-KERNEL's row governs the form and location of any `kernel.*` diagnostic a plugin row paraphrases; for `kernel.test_provider_forbidden` that is M-KERNEL:76's `plugin "<plugin>" › provider "<name>"` (V-a's DONE2-NOTIF-001 and DONE2-STORAGE-001). - notifications (`transport::forbidden`): `› transport "<name>"` → `› provider "<name>"` (smtp, memory). - storage (`DiskConfig::problems`, the test-only disk refusal only): `› disk "<name>"` → `› provider "<name>"`; the disk's other diagnostics keep their location. - bookshelf's worker (the plain SMTP transport in staging or production): `bookshelf-worker › mail transport` → `plugin "bookshelf" › provider "smtp"`. - The kernel's own resolver and the idempotency memory store already used the form. Messages and fixes are unchanged. The native witnesses (the two staging or production test-provider rows and R-STORAGE-01) and the unit and conformance tests assert the kernel form; names and prefixes are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
| config/environments | ||
| crates | ||
| docs | ||
| examples | ||
| migrations | ||
| plugins | ||
| security | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CLAUDE.md | ||
| deny.toml | ||
| LICENSE | ||
| NOTICE | ||
| README.md | ||
| rust-toolchain.toml | ||
Minco
Minco is a Rust framework for building business web applications that cost as little as possible to run on AWS, without giving up correctness: explicit transactions, idempotent commands, durable jobs, append-only audit, real second-factor authentication, exact decimals, generated API clients and a deployment plan whose monthly cost you can read before you apply it.
It takes Laravel as its design-philosophy reference: a small integrated foundation, first-party plugins you opt into (each declaring its tables, workers and cost), starter files copied once into your application, and application code that owns every business rule. Where Laravel relies on a runtime container, facades and an ORM, Minco uses explicit Rust composition, typed contracts and visible SQL.
What you get
| Built in (free when unused) | Plugins (opt in, declared cost) |
|---|---|
| composition root and plugin lifecycle, typed configuration with secret references, HTTP conventions (request IDs, problem-details errors, validated extractors, pagination), contract-first OpenAPI 3.1 with generated clients, PostgreSQL pools and forward-only migrations, authorisation primitives (principal, active context, policies, scope filters), rate limiting, idempotency receipts, durable jobs and outbox abstraction, structured observability, a test kit that refuses to skip, a CLI, local development supervision, deployment plan with cost model, release tooling | authentication with sessions and second factors (auth), runtime settings with revisions (settings), PostgreSQL and SQS job drivers, append-only audit (audit), mail and in-app notifications (notifications), object storage (storage), image validation and derivatives (media), PDF and true XLSX exports (exports), static single-page-app delivery (static-site), AWS Lambda runtime adapter (aws-lambda) |
Two runtime profiles serve the same router: a persistent process (one small instance, in-process worker) and AWS Lambda. The reference deployment for a small tenant is priced line by line in docs/decisions/ADR-003.md.
Status
Walking-skeleton stage: the documentation under docs/ is the contract a builder implements. The first slice (T-M-001) adds the Cargo workspace, crates/minco and a minimal crates/minco-core, tools/verify, and examples/bookshelf, one thin path from a browser page through the generated TypeScript client, the API and PostgreSQL 18.6 to a durable job and a local mail sink. Only the verifier's gate declares a milestone done. Start with docs/product.md, then docs/architecture.md and docs/task-graph.md.
Layout
See AGENTS.md for the crate map, invariants and commands.
Licence
MIT. See LICENSE.