docs: retarget references to spec.md (root) and drop docs/* self-refs
The repo is moving the formal spec to /spec.md and retiring the
predecessor docs/troubleshooting.md and docs/publishing-single-binary.md
(this wiki already covers them more comprehensively). Update internal
wiki references accordingly.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
rkttu
committed
May 28, 2026
docs: wiki v1 — ground every page in src/, samples/, and the spec
Replaces the initial scaffold (which contained stub _TODO_ markers and
some invented APIs like Web.HostUrls / Agent.HostName()) with an
English first version verified against the actual code:
- Tier 1 API now reflects the real exported surface per SDK
(Sh.*, Fs.*, Http.*, Env.*, Json.*, Prompt.*, plus per-SDK
additions). System.Console is intentionally absent from Mcp.
- Cadenza.Web: dropped non-existent host helpers, documented bind
via ASPNETCORE_URLS / --urls / Web.App.Urls. Added DI, CORS,
drop-down to Web.App.
- Cadenza.Agent: Port / HostName / ServedModelName are property
assignments, not function calls. Added OpenRouter via
UseChatClient with custom OpenAIClientOptions. Added ChatLoop /
Reply alongside Run. Listed both /v1/chat/completions and
/v1/responses endpoints.
- Cadenza.Worker: documented Config<T> / Service<T> must be called
inside the Run callback (host is built lazily).
- Cadenza.Mcp: Tool / Resource / Prompt with worked examples;
explicit warning that WriteLine corrupts the JSON-RPC stream;
client config snippets for Claude Desktop / Cursor / VS Code /
docker.
- Cadenza.Console: real cookbook entries (deploy guard, typed HTTP
fetch with source-gen JsonSerializerContext, interactive
Prompt.*).
- Deployment: aligned with docs/publishing-single-binary.md
(EnableCompressionInSingleFile, IncludeNativeLibrariesForSelfExtract,
InvariantGlobalization). Container page now uses real
Container* MSBuild properties and shows the 0.0.0.0 caveat
per SDK.
- Installation / Getting Started: added Cadenza.Templates
(dotnet new cadenza, cadenza-worker, cadenza-web, cadenza-mcp,
cadenza-agent).
- Editor Setup: concrete steps for VS Code, Cursor / Kiro forks
(Open VSX dotnetdev-kr-custom/csharp), Rider, VS 2026.
- New page: Troubleshooting — wildcard #:sdk, stale NuGet cache,
MCP stdio framing, container binding, Worker host not started,
Agent backend not configured.
- Home + sidebar updated to include Troubleshooting.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
rkttu
committed
May 28, 2026
docs: scaffold wiki — Home, sidebar, footer, getting started, 5 SDK pages, Tier 1 API, directives, deployment (single binary + container), samples index, FAQ
Initial English-only skeleton. Pages stub the structure with real code
drawn from samples/ and the docs/spec.md, with _TODO markers where
deeper content needs to follow. Korean mirrors are not in this skeleton
and remain a follow-up decision per the launch plan.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
rkttu
committed
May 28, 2026