Add 60-second kaios tour transcript#30
Merged
morning-verlu merged 1 commit intoJun 20, 2026
Merged
Conversation
Closes morning-verlu#19: a first-time visitor can now see what kaios tour prints before installing KAI OS. The new section in docs/LOCAL_TOUR.md reproduces the key output moments (header, what happened:, product proof:, artifacts:, next:) and links the three artifacts the tour writes. The four-line product proof: mapping (Agent = Process, Tool = Syscall, Run = Evidence, CI = Gate) is visible to anyone scanning the docs. Transcript is transcribed byte-for-byte from the canonical renderTourText function in kaios-cli/src/main/kotlin/ai/kaios/cli/Main.kt (lines 956-988). Run-id and path values are placeholders. Also adds the planning artifact docs/plans/2026-06-19-001-feat-tour-transcript-plan.md that documents the work. Co-Authored-By: Claude <noreply@anthropic.com>
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
A first-time visitor can now see what
kaios tourprints before installing KAI OS. The new "60-Second Tour Transcript" section indocs/LOCAL_TOUR.mdreproduces the key output moments (header,what happened:,product proof:,artifacts:,next:) and links the three artifacts the tour writes so a reader knows what to open after running it themselves.The four-line
product proof:mapping —Agent = Process,Tool = Syscall,Run = Evidence,CI = Gate— is now visible to anyone scanning the docs, which is what issue #19 asked for.Notes for reviewer
renderTourTextfunction inkaios-cli/src/main/kotlin/ai/kaios/cli/Main.kt(lines 956-988). Run-id and path values are placeholders (<run-id>,<workspace>,<path-to-artifact>,<path-to-trace>,<path-to-capsule>) since they vary per run.git diff --checkhalf of the issue's verification passes. The livekaios tour --dir /tmp/kaios-tour-checkhalf is currently blocked on this checkout by a pre-existing, unrelated bug inquickstartPlan(kaios-cli/src/main/kotlin/ai/kaios/cli/Main.kt:1148) that uses a literal<run-id>.jsonplaceholder where a real path is required. The bug predates this branch (introduced in3a05858, Jun 16) and is independent of this docs change. A reviewer can re-verify the transcript by readingrenderTourTextdirectly.Post-Deploy Monitoring & Validation
No additional operational monitoring required. This is a docs-only change with no runtime effect.
Closes #19.