Genocs.Common

Genocs.Common — Agent Reference Documentation

Consumer Mode for Agents

  • Assume package is installed from NuGet
  • Do not rely on repository source code access
  • Prefer stable public APIs and extension methods documented here
  • If behavior is uncertain, fail safely and request config/package version details.

Purpose

Genocs.Common provides reusable contracts and primitives for CQRS, domain modeling, paging, and cross-cutting concerns.

Quick Facts

KeyValue
PackageGenocs.Common
Target frameworksnet10.0, net9.0, net8.0
Primary roleShared contracts and foundational types
Core entry pointsICommand, IQuery<TResult>, IEvent, IPagedQuery, PagedResult<T>

Install 

dotnet add package Genocs.Common

Minimal Integration Recipe (Program.cs) 

using Genocs.Common.CQRS.Commands;
using Genocs.Common.CQRS.Queries;

var builder = WebApplication.CreateBuilder(args);

public sealed record CreateBook(string Title) : ICommand;
public sealed record GetBook(Guid Id) : IQuery<BookDto>;
public sealed record BookDto(Guid Id, string Title);

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

Configuration

Genocs.Common exposes the shared app section through AppOptions.

{
  "app": {
    "enabled": true,
    "name": "BookStore",
    "service": "bookstore-api",
    "instance": "bookstore-api-01",
    "version": "1.0.0",
    "displayBanner": true,
    "displayVersion": true
  }
}
SettingTypeDescription
enabledboolEnables use of the section by modules that consume AppOptions.
namestringHuman-readable application name.
servicestringService identifier used by infrastructure and diagnostics integrations.
instancestringInstance identifier for the running process or container.
versionstringApplication version exposed to logs, banners, and diagnostics.
displayBannerboolShows the startup banner when supported by the host.
displayVersionboolShows the configured version at startup.

This package does not enforce the section itself, but downstream packages such as logging, telemetry, and hosting conventions commonly read app metadata.

Decision Matrix For Agents

If you need to…Use
Model a command contractICommand or ICommand<TResult>
Model a query contractIQuery<TResult>
Model an integration or domain event contractIEvent
Standardize paged request inputIPagedQuery or PagedQueryBase
Standardize paged response outputPagedResult<T>

Behavior Notes / Constraints

  • This package exposes contracts and shared models; it does not register runtime dispatch services by itself.
  • Command/query/event execution requires a runtime package that provides handlers and dispatchers.
  • Consistent identifier conventions across contracts reduce mapping and persistence issues.

Public Capability Map

  • CQRS contracts: ICommand, ICommand<TResult>, IQuery<TResult>, IEvent
  • Handler contracts: command/query/event handler interfaces used by runtime modules
  • Paging models: IPagedQuery, PagedQueryBase, PagedResult<T>
  • Shared abstractions: domain and user-context interfaces for cross-module consistency

Dependencies

  • MediatR.Contracts
  • Humanizer.Core
  • NetArchTest.Rules

Troubleshooting

  1. Contracts compile but no business logic runs. Fix: Add a runtime package that registers handlers and dispatchers for your command/query/event contracts.
  2. Pagination shapes differ across endpoints. Fix: Normalize request and response contracts on IPagedQuery and PagedResult<T>.
  3. Domain objects use mixed identifier patterns. Fix: Standardize a single ID strategy and apply it consistently across contracts and entities.
Last modified on March 24, 2026
Edit this page on GitHub
Genocs.Core →