crucible.cli
1.3.0
See the version list below for details.
dotnet tool install --global crucible.cli --version 1.3.0
dotnet new tool-manifest
dotnet tool install --local crucible.cli --version 1.3.0
#tool dotnet:?package=crucible.cli&version=1.3.0
nuke :add-package crucible.cli --version 1.3.0
Crucible
Static documentation generator that transforms Markdown into HTML through an XML intermediate representation and XSLT 4.0 transformation.
Packages
| Package | Description | Install |
|---|---|---|
| Crucible.Cli | Command-line tool | dotnet tool install -g Crucible.Cli |
| Crucible.Extensions | Extension library (Mermaid diagrams, plugin API) | Library — reference in your project |
Quick start
# Install the CLI
dotnet tool install -g Crucible.Cli
# Create a new docs project
crucible init
# Build the site
crucible build
Features
- Markdown in, HTML out — write docs in Markdown with YAML frontmatter
- XSLT-powered — transforms via the PhoenixmlDb XSLT 4.0 engine
- Client-side search — Lunr.js with pre-built index
- Dark mode — automatic with manual toggle
- SEO — Open Graph, canonical links, sitemap.xml
- Extensible — plugin model for custom Markdown processing
- LLMs.txt — auto-generated site overview for AI consumption
Documentation
Full documentation at phoenixml.dev
License
Apache 2.0
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
**Takes `PhoenixmlDb.Xslt` from 2.1.0 to 2.2.0.** No Crucible source changed; the engine did.
Minor rather than patch because the engine carries behaviour changes — see `PhoenixmlDb.Xslt`
2.2.0 — even though none of them alter what this tool produces.
### Verified
134 tests pass, unchanged from the 2.1.0 pin.
**The rendered site is byte-identical**, both pipeline stages, against the same docs source
(`phoenixml-docs` @ `1be1049`):
| stage | files differing |
|---|---|
| `ParseOnly` — Markdown to intermediate XML | 0 of 116 |
| `TransformOnly` — XML to HTML | 0 of 116 |
The arms were confirmed to differ before that result was trusted — an A/B that silently runs one
engine twice produces exactly the same clean diff. Read from each build's `deps.json`:
```
control: PhoenixmlDb.Xslt/2.1.0 PhoenixmlDb.XQuery/2.1.0
new: PhoenixmlDb.Xslt/2.2.0 PhoenixmlDb.XQuery/2.2.0
```
So a release containing an O(n²) matching fix and nine correctness fixes changes this site's
output by nothing, which is the reassuring answer rather than a suspicious one: the site's
stylesheets do not use the constructs those fixes touch.
Releases are **tagged**, and the tag is the version. Pushing `v<version>` packs and
publishes `crucible.cli`; pushes to `main` build and test but never publish.
Headings below 1.1.76 cover a *range*, because until 77a49e9 CI published every
push to `main` with the version set to `1.1.${commit_count}` — one NuGet version
per commit, so the published history was a merge log rather than a record of
decisions. Those ranges are kept as-is; the highest version in a range is the
first one containing all of the work described.