Tell the truth everywhere: refreshed docs and an honest landing page - #43
Merged
Conversation
… and a verified tool reference Every documentation surface now matches the shipped product: five tool groups and 25 actions, local embeddings as the zero-config default, bundled embedded storage with no separate Redis install, the graph explorer as it actually behaves, the history window, and ownership analysis. The landing page drops the four-tool era copy and synthetic art for real captures from a fresh index, with install commands clearly gated on the pending npm publication. All numbers were re-measured or re-derived from source during an independent review that found zero blockers. Co-Authored-By: Claude Fable 5 <[email protected]>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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
1 participant
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.
What changed
CODEGRAPH_RAW_TOOLS=true(the doc said1, the code checks the literaltrue), the graph explorer's real capabilities, ownership in the analyze summary, no registry-install claims on unpublished packages, Jina removed everywhere (the code rejects it), embedded storage documented with bundled binaries instead of a redis-server prerequisite, and the types README's edge inventory now matching the actual 18-member union.apps/web): product-first sections (setup, explorer, analysis, platform, release confidence), five tool groups / 25 actions, all metrics re-measured on a fresh isolated index during the rewrite (a 1000-node project window: 750,767 bytes legacy vs 305,248 bytes compact, 59% smaller), five real sanitized captures replacing the synthetic hero art and placeholder assets, invalid driver values and the wrong npm name removed, and three visible not-yet-published gates on install commands. Apnpm audit:claimsscript keeps the page's claims pinned to source.profileschema gap documented honestly.mcp.json.examplenow shows a source-checkout config and a post-publication config, with no fake secrets. SECURITY.md stops implying the package is published. Zero em-dash characters remain in any touched file.Verification
Three fixers with disjoint ownership; an independent review round re-derived 26 facts from source, swept all surfaces for stale claims (zero live hits), executed the documented snippets, served and browser-tested the production landing at 390px and 1440px (zero console errors, all anchors and images good), inspected every capture at full resolution for leaked local paths (none), and confirmed ownership and zero U+2014 across 52 changed files: PASS with no blockers. Full tree: build 21/21, tests 36/36, typecheck 20/20.
Deliberately not in this PR
Source defects found during the docs work are tracked separately, not patched here: the mcpb manifest missing the analyze tool, the profile action's schema omitting two params, extensionless ESM imports in built dist output, a file-relationships 500 on nodes without derivable ids (fix in progress on its own branch), and a 1440px toolbar overlap.
🤖 Generated with Claude Code