dotnet-runic 0.3.0-preview.1

dotnet-runic

Run generated-command diagnostics and coordinate local development for a Runic Application.

Generated applications pin this tool locally:

dotnet tool restore
dotnet runic doctor --project path/to/App.csproj

For other projects, install it globally with dotnet tool install --global dotnet-runic --prerelease. The frontend may use Node.js with npm or pnpm, or Bun; doctor reads the declared packageManager and committed lock file, then checks the matching toolchain. Use dev to run the managed host with configured Vite, Angular, or custom frontend development support and inspect for generated diagnostics.

Vite+ remains an optional facade over that declared manager and the standard project scripts. vp run dev is compatible with generated projects, but dotnet runic dev deliberately uses the underlying npm, pnpm, or Bun declaration so the reproducible build does not depend on a separate global Vite+ installation.

dotnet runic dev --project path/to/App.csproj
dotnet runic dev --project path/to/App.csproj -- --safe-mode profile-a
dotnet runic inspect --project path/to/App.csproj
dotnet runic migrate --check

Local support envelope

support only reads an explicitly selected Editor diagnostic ZIP. It can preview the selected collector and every omission, collect one unsigned local JSON envelope, or verify and remove that envelope. It never launches a product, scans a workspace, uploads data, opens a network transport, or configures telemetry.

dotnet runic support --mode preview --editor-diagnostics /path/to/editor-diagnostics.zip
dotnet runic support --mode collect --editor-diagnostics /path/to/editor-diagnostics.zip --destination /path/to/support-envelope.json
dotnet runic support --mode remove --destination /path/to/support-envelope.json

The collector accepts only runic.translations.editor-diagnostics/1 and rejects paths, source/translation/review text, sessions, cookies, and tokens. The resulting runic.support-envelope/1 contains normalized application/workspace counts plus a fixed omission record; it is not a telemetry or hosted-diagnostics API.

Everything after -- is forwarded unchanged to the application, including option-looking and negative values. The tool reads optional project properties and runs only your configured local commands. See the development guide, examples, and issues. Preview tool; MIT licensed.

Application host selection

dotnet runic dev --host desktop|cswebui selects the matching project references, contract generation, frontend build and child process environment. Generated projects expose RunicHost; normal builds and publishes accept -p:RunicHost=cswebui. Restore when changing hosts. With no override, dev uses the project selection. Development progress streams immediately; JSON mode keeps progress on stderr and reserves stdout for the final result envelope.

Hosts opt into the generated frontend development document by calling assets.WithDevelopmentDocument(). Only the explicit bounded entry document is replaced. The remaining asset manifest is unchanged.

Publish measurements

dotnet runic size --runtime linux-x64 --host desktop --profile minimal --report measurements/minimal.json publishes a fresh self-contained NativeAOT distribution and records disk/ZIP bytes, file hashes, package versions, evaluated settings and behavior-check status. --verify <executable> and repeated --verify-argument <value> invoke a shell-free checker against the published directory and main executable. Without a checker the report says not-run. See the size and tuning guide.