Monica.Generators.AutoController 1.0.0-rc.12

Monica

Architecture agents can follow. Systems humans can inspect.

Monica is an agent-governed application architecture for observable .NET backends. Its packages provide host-scoped module composition, typed DDD ProjectUnits, infrastructure adapters, operational dashboards, and runtime diagnostics.

Install

Install only the capabilities the host uses:

dotnet add package Monica.ProjectUnits --prerelease
dotnet add package Monica.JobScheduler --prerelease
dotnet add package Monica.JobScheduler.UI --prerelease

Compose one host

using Monica.Core.Modularity.Extensions;
using Monica.Modules;

var builder = WebApplication.CreateBuilder(args);

builder.AddMonica(monica =>
{
    monica.ConfigureApplication(options =>
    {
        options.AppName = "Orders";
        options.AppId = "orders";
    });

    monica.AddProjectUnits();

    monica.AddJobScheduler()
        .UseInMemoryMetadataRepository()
        .UseSchedulerScope("orders")
        .UseInMemoryProvider();

    monica.AddJobSchedulerUI();
});

var app = builder.Build();
app.UseMonica();
app.MapMonica();
app.Run();

AddMonica(...) records and validates the complete module graph for this host before applying registrations. The composition is isolated from other hosts in the same process.

Each monica.Add*() call returns a host-bound ModuleRegistration<,> that provider and capability extensions enrich inside the same callback. Module strategies declare dependencies with Describe(ModuleDescriptor) and declare structural business-type queries with DeclareTypeDiscovery(...); Monica evaluates all non-empty plans through one type-universe scan and commits their matches deterministically.

Hosts that call monica.AddModuleSystem() receive an immutable, revisioned diagnostics snapshot, lazy assembly inventory, bounded option catalog with sensitive-value redaction, and sanitized portable exports. When Monica.UI is installed, monica.AddModuleSystemUI() includes that Core diagnostics module automatically.

Maturity tiers

• Stable: Core, ProjectUnits, WebApi, Configuration, Repository, JobScheduler, OpenTelemetry, and UI runtime inspection.
• Integrations: optional EF Core, Kafka, Redis/StackExchange, Dapr, SignalR, and other provider adapters.
• Labs: fast-moving AI/RAG/MCP, DataChannel, DevOps and profiling, Office, and Experimental capabilities.

The package catalog is validated in CI: Stable can depend only on Stable, Integrations can depend on Stable or Integrations, and Labs may opt into any tier.

Learn more

• Documentation: https://monica.dpdns.org/
• Reference application: https://github.com/Tairitsua/Monica/tree/dev/examples/Monica.ReferenceApplication
• Repository: https://github.com/Tairitsua/Monica
• Issues: https://github.com/Tairitsua/Monica/issues

Monica is MIT licensed and remains pre-1.0 while its public architecture is finalized.