docs: Crucible, isolated profiles & cost governance + 0.12.x feature coverage - #103
Draft
FerroxLabs wants to merge 1 commit into
Draft
docs: Crucible, isolated profiles & cost governance + 0.12.x feature coverage#103FerroxLabs wants to merge 1 commit into
FerroxLabs wants to merge 1 commit into
Conversation
….12.x features User-facing docs lagged the 0.12.7→0.12.14 feature surface. This adds three new pages and threads shipped features into existing docs, all researched and verified against the shipped code on main: New: - docs/crucible.md — Mixture-of-Providers council: enabling, CLI + flags, manual vs auto assembly, the stakes gate, provider pinning, fusion, injection fencing, advisor/terminal modes, and three-level cost gating. - docs/profiles.md — isolated WAYLAND_HOME profiles: the full `profile` command family, activation precedence, isolation/secret guarantees, and the isolated-profile vs `--profile` config-selector disambiguation. - docs/cost-governance.md — token-spend governance + Crucible council caps. Updated: - docs/providers.md — capability-first tool gating (#389), Flux context-routing, Sakana/Fugu provider. - docs/mcp.md — smart tool curation (max_tools, BM25 ranking, server provenance). - docs/README.md — rebuilt the index to link all 20 user-facing docs (was 7).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation update closing the gap between shipped features (0.12.7→0.12.14) and the user docs, which were last meaningfully touched 2026-06-19. Every page was researched and verified against the shipped code on
main(a verify pass re-checked every config field, flag, command, and default against source; fabrications fixed inline).New pages
docs/crucible.md— the Mixture-of-Providers council: opt-in/BYO-keys framing,[crucible]config, thewayland-core crucibleCLI + every flag, manual vs auto assembly, the Low/Med/High stakes gate, provider-pinning spec format, proposers/aggregator/fusion, prompt-injection fencing, advisor vs terminal mode, and three-level cost gating. Includes the existingcrucible-run.png/crucible-tui.pngscreenshots.docs/profiles.md— isolatedWAYLAND_HOMEprofiles: the fullprofilecommand family (create/use/list/show/rename/delete/export/import), activation precedence, what's isolated, secret-handling guarantees, and an isolated-profile vs--profileconfig-selector disambiguation.docs/cost-governance.md— token-spend governance + Crucible council caps in one place.Updated pages
docs/providers.md— capability-first tool gating (#389), Flux context-routing, Sakana/Fugu provider.docs/mcp.md— smart tool curation (max_tools, BM25 ranking, server provenance).docs/README.md— rebuilt the index to link all 20 user-facing docs (was 7).Notes for review
daily_cap_usdaccumulates per-process within one CLI invocation (cross-process daily persistence is a later stage); cost-governance tree counters roll up to the immediate parent, not transitively.--profile <name>is overloaded — it pointsWAYLAND_HOMEat an isolated profile and feeds the config-section selector, which errors if there's no matching[profiles.<name>]section. Documented as a "sharp edge"; may warrant a product fix.