Robotico.Repository.MishimaDocs 1.0.0
Robotico.Repository.MishimaDocs
NuGet package id: Robotico.Repository.MishimaDocs — IRepository<TEntity, TId> and IAsyncRepository<TEntity, TId> over the MishimaDocs engine (JSON documents per entity id). This repo slug uses mishimadocs for checkout layout only.
Target framework: net10.0 only (matches the MishimaDocs engine).
Which interface?
| Host / scenario | Prefer |
|---|---|
Async hosts with IMishimaAsyncDatabase and HasAsyncPersistence |
IAsyncRepository<,> for non-blocking writes (IMishimaAsyncCollection) |
| Sync-only opens or reads | IRepository<,>; GetByIdAsync uses synchronous MishimaDocs reads |
Unit of work profile (IUnitOfWorkCapabilities)
UnitOfWorkCommitMode |
NoOpCommitSuccess |
CommitCoordinatesDomainWrites |
no — each repository call persists immediately |
SupportsTransactions |
no — use MishimaDocs IMishimaWriteBatch / IMishimaAsyncWriteBatch for atomic multi-document writes |
MishimaDocsUnitOfWork.CommitAsync succeeds but does not batch repository operations; align expectations with UnitOfWorkGuard in apps that require deferred commits.
Build (Robotico monorepo)
MishimaDocs (dual mode): with the monorepo layout (csharp/robotico-repository-mishimadocs-csharp and mishima-suite two levels above this folder), MSBuild binds the engine via ProjectReference (MishimaDocsProjectPath). Standalone clones without those sources consume MishimaDocs as a PackageReference (version in Directory.Packages.props). See csharp/build/ROBOTICO_NUGET_DUAL_MODE_PLAN.adoc and ROBOTICO_REPOSITORY_OUTBOX_MISHIMA_DOCS_IMPLEMENTATION.adoc.
dotnet restore Robotico.Repository.MishimaDocs.sln
dotnet build Robotico.Repository.MishimaDocs.sln -c Release
dotnet test Robotico.Repository.MishimaDocs.sln -c Release
MishimaDocsUnitOfWork is a no-op CommitAsync (each repository call commits immediately through MishimaDocs). Use IMishimaWriteBatch in application code when you need atomic multi-document writes.
CI and quality bar
GitHub Actions runs build, tests, coverlet, a line-coverage gate on Robotico.Repository.MishimaDocs, and — in the umbrella csharp/ layout — verify-robotico-library-bar.ps1. Same rules as other Robotico C# libraries: one top-level type per file, explicit types (.editorconfig / IDE0008). See csharp/build/ROBOTICO_LIBRARY_10_STANDARD.adoc.
License
See LICENSE.