docs: explain the supply-chain-graph-data branch in the querying guide (fixes #204) - #207
Merged
Merged
Conversation
The querying guide only showed indexing the in-repo folder/examples and never said the real, workflow-generated events live on the append-only supply-chain-graph-data branch. Add a 'Where the data lives' section with the fetch + worktree + index steps, the schema note (#203), and the graph-service git-sync path. Fixes #204
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the observability querying guide to explain that real supply-chain graph events are stored on the workflow-updated supply-chain-graph-data branch (not main), and documents how to fetch and index that data locally.
Changes:
- Adds a “Where the data lives” section distinguishing in-repo schema/examples from the workflow-generated data branch.
- Documents
git fetch+git worktree+cssc-graph indexsteps for indexing real event data. - Notes how
graph-serviceobtains the same data via git-sync intoDATA_ROOT.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
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.
Fixes #204.
The querying guide only demonstrated indexing the in-repo
supply-chain-graph/folder and itsexamples/fixtures — it never told readers that the real, workflow-generated events live on the append-onlysupply-chain-graph-databranch, so following the guide only ever showed fixture data.Adds a 'Where the data lives' section (before Experience 1) that:
record-graph-events);git fetch+git worktree+cssc-graph indexsteps;schema/(kept in sync by Collector must sync schema/ to the supply-chain-graph-data branch (new event kinds fail to index) #203), so no--schema-diroverride is needed;graph-servicegit-sync path (supply-chain-graph-data→DATA_ROOT).Kept the example-based walkthrough intact; edited on disk (notebook buffer) — 27 insertions, no reflow.
Companion: #203 (schema sync, PR #206), #205 (surface referrers/deletions).