Codebelt
v0.13.1

Executable C# Evidence with csrun

Construct, verify, repair, and audit standalone C# examples and xUnit v3 tests with paired Native and Docker execution evidence.

.NET Engineering 1 installs .NET 10+ SDK or Docker with Linux containers PowerShell 7+ xUnit v3 & Microsoft Testing Platform

Overview

Executable C# Evidence with csrun builds and runs standalone C# console programs and genuine xUnit v3 tests through C# Example & Test Runner (csrun) and its schema version 1 manifest contract. It covers four workflows — create, verify, repair, and audit — so documentation snippets, library examples, and minimal reproductions are backed by real runtime observations rather than assumed correctness.

Every compatible deliverable is generated from one canonical manifest into two self-contained PowerShell 7 execution blocks: one for a native .NET environment and one for a disposable Linux Docker container. Both resolve and SHA-256-verify the latest stable csrun release at runtime, keep exact package pins and target frameworks intact, and report each transport's verification status independently.

Concepts

  • Feasibility before execution: inspects source, imports, entry points, dependencies, and host assumptions first — classifying each sample as Compatible, Adaptable, Unsupported, or Undetermined before constructing a manifest so multi-project or entrypoint-owned application topologies are separated from standalone execution.
  • One manifest, two transports: derives independent Native and disposable Docker PowerShell 7 blocks from a single canonical manifest with exact PackageId@Version pins, never promoting one transport's outcome as proof for the other.
  • Honest evidence classification: separates Verified, Compiled only, Unverified, and Failed outcomes using captured stdout, stderr, exit status, and positive xUnit v3 / Microsoft Testing Platform discovery counts instead of treating exit zero or zero discovered tests as a pass.
  • Semantics-preserving repair and audit: keeps verify strictly read-only, preserves original failure evidence during authorized repairs, never weakens assertions or alters intent to force a pass, and leaves intentionally partial documentation excerpts intact during scoped audits.

Installation

npx skills add https://github.com/codebeltnet/agentic --skill dotnet-csrun

Usage guidance

Invoke this skill when creating a new runnable C# example or isolated xUnit v3 test, verifying whether existing code or documentation snippets still run, repairing broken examples without changing their intent, or auditing documentation fences across a scope. It composes with .NET DocFX Digest Steward for standalone documentation examples while keeping repository-backed integration examples, repository test suites (.NET Test, .NET Remote Testing), and performance experiments (.NET Benchmark) in their own workflows.

Native and Docker prerequisites are probed independently so a missing host SDK does not block Docker execution and an unavailable Docker daemon does not block native execution. When neither transport is available for the requested framework, the skill preserves the target framework, names the missing prerequisites, and delivers both runnable blocks explicitly marked Unverified.