AtomiCloud.Diene.Result.TestHelper 1.0.0

AtomiCloud.Diene.Result

Diene's reproducible development environment is managed by Nix. Run direnv allow once, then use pls tasks from the loaded shell.

This branch is the workspace baseline inherited by every downstream sample: split CI/CD, secrets, release configuration, validators, standards, and vendored agent-skill synchronization.

Commands

• pls setup — synchronize installed diene package skills.
• pls lint — run every pre-commit gate.
• pls secret:scan — scan tracked content for secrets.
• pls skills:sync — rebuild .claude/skills/vendor/ from installed packages.

Standards

• CI/CD workflows
• conventional commits
• Infisical and secrets
• linting and pre-commit
• Nix flakes and development shells
• release automation
• service-tree identity
• shell scripts
• Taskfile conventions

Shared standards

• Authorization
• Contributor documentation
• Date and time
• Domain-driven design
• Functional practices
• Software design philosophy
• SOLID principles
• Stateless OOP and dependency injection
• Testing
• Three-layer architecture
• Utility libraries
• Data validation

Domain-specific documentation belongs under docs/domain/. The docs/standards/contracts/ location is reserved for the separately owned C0 contracts standard.

.NET 10 foundation

This branch adds the .NET 10 toolchain, the App/Lib/UnitTest/IntTest sample, merged multi-project coverage, strict and LLM dead-code modes. See the .NET baseline.

Common commands:

• pls build, pls dev, pls run, and pls preview
• pls test, pls test:unit, pls test:int, and the coverage variants
• pls deadcode for the non-blocking review; CI owns strict dn-inspect

The Result/Option contract is documented in docs/domain/result.md.

Publishable library packages

This repository publishes AtomiCloud.Diene.Result and the companion AtomiCloud.Diene.Result.TestHelper package at one committed version. The library provides guarded rich structs for Result<T, E> and Option<T>, dotnet-idiomatic railway composition, explicit exception capture, async composition, and versioned C0 JSON tuple codecs. It has no runtime dependency and no dependency on a Problems package.

dotnet add package AtomiCloud.Diene.Result
dotnet add package AtomiCloud.Diene.Result.TestHelper

using AtomiCloud.Diene.Results;
using AtomiCloud.Diene.Results.TestHelper;

Result<int, string> parsed = Result.Ok<int, string>(21);
var answer = parsed.Map(value => value * 2);
answer.Should().BeOk(42);

The package ID is singular but the namespace is plural AtomiCloud.Diene.Results; this avoids the namespace/type collision between a namespace tail and the Result type. Use Result.Ok/Result.Err when the success and error types are identical. Serialize only ResultSerial and OptionSerial, never the in-memory structs.

Run nix develop .#ci -c ./scripts/ci/pkg-validate.sh to pack both packages, validate metadata and symbols, and restore them into a scratch consumer. See the library baseline for release and promotion guidance.