docs: close the drift the self-audit found, and state the trusted-host posture - #310
Merged
Merged
Conversation
…t posture Ten stale statements from the audit's documentation pass (sem 5.4, 5.6, 5.7, 5.12, 5.17): the README's "No JavaScript" claim for a dashboard that inlines two scripts of its own; a "session-file links" feature whose links never render (the renderer refuses absolute paths and Pi session files are absolute); MANUAL's default pipeline named as the six-phase single-scan variant and "four evidence levels" where the vocabulary has five; the quickstart's mechanical-scan scope listing the semantic passes; an INDEX.md footer naming a `codecarto library-reindex` CLI that exists on no surface; and the codecarto_complete description that named only the stub case when a supplied closeout_content overwrites the canonical closeout (#265). docs/client-surfaces.md gains the trust posture the audit's L6 group asked to be written down: the host is trusted, any writable absolute cwd is valid, an api_key argument lands in host logs (the tool description now says so), a committed config's library.path widens the Pi sandbox, and the Broad-Side config is tracked with its key slot (#267). Closes #265. Closes #267. Co-Authored-By: Claude Opus 5 <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
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.
Closes #265 (L4) and #267 (L6). Docs plus two tool-description strings and one generated-footer string; suite 847/847.
#265 — documentation drift (sem 5.4, 5.6, 5.7, 5.12, 5.17)
<script>blocks of its own (a JSON data island and the search/filter code)" — what CLAUDE.md already sayspipeline-full-with-audit.yaml(6 phases)pipeline-full-with-deep-audit.yaml(7 phases), with the six-phase file named as the older variantINDEX.mdfooter: "regenerate withcodecarto library-reindex" (no such CLI)codecarto_library_reindexMCP tool" — incore/library.tsand the spec's examplecodecarto_completedescription: "creates a closeout stub … if one does not yet exist"closeout_content(plus decisions) overwrites the canonical closeout, which is whatwriteCompletionArtifactsdoesAlready fixed earlier: folded scalars in the library spec (#293),
codecarto_nexton a complete/stuck pipeline (#306), completion wording (#303).#267 — trust posture
docs/client-surfaces.mdgains Trust posture: the host is trusted: the server and the extension defend the repository from an LLM's mistakes, not the user from their host. Recorded so the port decides deliberately: any writable absolutecwdis valid with no allowlist or MCP confirmation; anapi_keytool argument lands in host logs (the argument's description now says so, and points at the environment variable); a committedconfig.yaml'slibrary.pathwidens the Pi write sandbox (relative values refused since #243); the Broad-Sideconfig.yamlis deliberately tracked and has a key slot. Nothing here is a code change — a tool that second-guessed its host would be unusable from every client.🤖 Generated with Claude Code