docs(wasteland): add Wasteland product documentation section#10039
Open
docs(wasteland): add Wasteland product documentation section#10039
Conversation
…10028) * docs(kilo-docs): scaffold Wasteland docs section Add stub pages for the Wasteland federated work protocol under gastown/wasteland/ and register them in the code-with-ai nav. SideNav only renders one level of subLinks, so Wasteland pages are flattened into the Gastown subLinks list with a 'Wasteland: ' prefix. Content for each stub will be filled in by later beads in the convoy. * docs(kilo-docs): noindex Wasteland stub pages until content lands Adds a noindex frontmatter flag (read by _app.tsx, emits a robots noindex,nofollow meta tag) and applies it to the 7 Wasteland stub pages. Stubs are intentionally thin in this scaffolding PR; follow-up beads will flesh them out and remove the flag.
* feat(docs): add Wasteland Flow diagrams (federation, lifecycle, claim-to-stamp) * fix(docs): add px units to flowDiagram height attributes Reviewers flagged that unitless height values render as invalid CSS because Markdoc supplies them as strings. Adding px suffix matches all existing FlowDiagram usages in the codebase.
* docs(wasteland): flesh out Overview and Concepts pages - index.md: hero paragraph, What is the Wasteland, federation model with flowDiagram, roles table, Gas Town by Kilo benefits, navigation links, 4 BrowserFrame placeholders (settings, wanted board, mayor claiming, claim detail drawer) - concepts.md: 11 H2 sections covering Wasteland instance, federation, rig identity, wanted board, item lifecycle with flowDiagram, claims, evidence, stamps, reputation ledger, validators, DoltHub PRs - All unverified claims marked with TODO: verify comments - Cross-links to workflow, admin, and settings pages with /docs/ prefix * docs(wasteland): add placeholder screenshot images and TODO comments
Write full content for wasteland/quick-start.md (8-section happy path from prerequisites to getting stamped) and wasteland/settings.md (7 sections covering connection, upstream, rig handle, DoltHub PAT, filters, auto-submit, and admin settings). Include BrowserFrame placeholders, security callouts for fine-grained DoltHub PATs, and TODO: verify markers for unverified claims.
* WIP: container eviction save * docs(wasteland): fix stamp dimensions, claim TTL, item types based on verified protocol Correct inaccuracies across wasteland docs verified against gastownhall/wasteland source: - Remove Creativity dimension from stamps (only Quality/Reliability exist) - Add Severity (leaf/branch/root) and skill tags to stamp descriptions - Remove confidence level description (hardcoded to 1.0 in protocol) - Fix wanted item types to match protocol (add design, rfc, docs, inference; remove chore) - Confirm claims do not expire (no TTL mechanism in protocol) - Add wl unclaim reference for releasing claims - Add wl profile CLI reference for checking reputation - Note DOLTHUB_TOKEN/DOLTHUB_ORG env vars for CLI users - Clean up duplicate TODO verify comments - Add TODO verify notes for Gas Town-specific additions (Creativity dimension, auto-submit toggle) * docs(wasteland): add placeholder screenshots for missing image assets
* docs: verify and update wasteland workflow + admin pages against source code - workflow.md: update stamp dimensions to reflect actual stamps.valence JSON structure (quality + reliability), confirmed quality enum (excellent/good/fair/poor), note evidence must be a valid URL, clarify wl unclaim is the abandon mechanism (no gt_wasteland_abandon) - admin.md: update posting fields to show which are API-exposed vs wl-CLI-only, add review inbox owner+admin requirement callout, update inbox card kinds to match classifier (add Unknown), confirm quality enum in stamping section, note trust_level 0 for soft ban, add rig trust levels and PR management to permissions matrix, clarify two-tier API enforcement (member vs owner), update Create Your Own TODO with WS-Admin 7 ship status - concepts.md: update quality scale to use enum values not 1-5, replace wild-west mode with direct mode terminology, add confidence field reference, update TODO for Mayor tool name - quick-start.md: update quality scale to match confirmed enum * docs(wasteland): add admin settings section, PR commenting, and accuracy fixes - Add Admin Settings section to admin.md covering test admin access, pending PRs, rig management, and delete wasteland warnings - Add Commenting on PRs subsection to review inbox - Document admin-action subkinds (accept-upstream, close-upstream) in the review inbox card types - Fix flowDiagram height attribute per spec (550 not 550px)
![kilo-code-bot[bot]](https://avatars.githubusercontent.com/in/2193792?s=60&v=4){kind=small}
|
|
||
| The worker-side flow for picking up a wanted item, doing the work in your Gas Town, and turning completion into stamped reputation. | ||
|
|
||
| {% flowDiagram name="claim-to-stamp" height="550" /%} |
Contributor
There was a problem hiding this comment.
WARNING: Unitless diagram height collapses the flow diagram
FlowDiagram passes height straight into a React style string, so height="550" becomes invalid CSS (height: 550) and the container can collapse instead of rendering the diagram at the intended size. Other flow diagrams in these docs use CSS units; please restore 550px.
|
|
||
| <!-- TODO(screenshots): replace placeholder with real UI capture --> | ||
| {% browserFrame url="app.kilo.ai/gastown/town/rig/bead" caption="A bead with a wasteland link — the upstream item badge connects local work to the Wanted Board" %} | ||
| {% image src="/docs/img/gastown/wasteland/gt-bead-with-wasteland-link.png" alt="Bead with wasteland wanted item link badge" /%} |
Contributor
There was a problem hiding this comment.
WARNING: Referenced image asset is missing
This page references /docs/img/gastown/wasteland/gt-bead-with-wasteland-link.png, but the PR does not add that file and it is not present in the repo. The rendered docs will show a broken image for this BrowserFrame until the asset is added or the reference is changed.
|
|
||
| <!-- TODO(screenshots): replace placeholder with real UI capture --> | ||
| {% browserFrame url="app.kilo.ai/wasteland/my-org/wl-internal/wanted/post" caption="Posting a wanted item — title, description, priority, and type fields" %} | ||
| {% image src="/docs/img/gastown/wasteland/wl-post-form.png" alt="Wanted item post form" /%} |
Contributor
There was a problem hiding this comment.
WARNING: Referenced image asset is missing
This page references /docs/img/gastown/wasteland/wl-post-form.png, but that image is not added by this PR and does not exist in the repo. The docs page will render a broken screenshot placeholder here.
|
|
||
| <!-- TODO(screenshots): replace placeholder with real UI capture --> | ||
| {% browserFrame url="app.kilo.ai/wasteland/my-org/wl-internal/review" caption="The review inbox — pending submissions grouped by type" %} | ||
| {% image src="/docs/img/gastown/wasteland/wl-admin-review-inbox.png" alt="Admin review inbox showing pending submissions" /%} |
Contributor
There was a problem hiding this comment.
WARNING: Referenced image asset is missing
This page references /docs/img/gastown/wasteland/wl-admin-review-inbox.png, but that image is not added by this PR and does not exist in the repo. The review inbox screenshot will be broken in the rendered page.
Contributor
Code Review SummaryStatus: 4 Issues Found | Recommendation: Address before merge Overview
Issue Details (click to expand)WARNING
Other Observations (not in diff)Issues found in unchanged code that cannot receive inline comments:
Resolved since previous review:
Files Reviewed (2 files)
Fix these issues in Kilo Cloud Reviewed by gpt-5.5-20260423 · 577,519 tokens |
marius-kilocode
approved these changes
May 7, 2026
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.
Summary
Adds the Wasteland documentation section to kilo-docs — 7 pages covering overview, quick start, concepts, workflow, administration, settings, and troubleshooting, plus 3 interactive flow diagrams and navigation integration.
All pages use
noindex: truefrontmatter (draft status). Includes 7 placeholder screenshots (identical stubs) and 1 empty troubleshooting stub to be filled in later.Review notes
.kilo/package-lock.jsonand.kilocode/package-lock.jsondowngrade@kilocode/pluginfrom 7.2.31 → 7.2.14 (likely accidental from agent install). These should be reverted before or after merge.typevalues differ across pages —concepts.mdsaysbug/feature/chore,admin.mdsaysfeature/bug/docs/other,quick-start.mdsaysbug/feature/design/rfc/docs/inference. Should be reconciled.troubleshooting.mdis empty (stub only).