feat(report): live graph report endpoint + quipu_report MCP tool (hq-ct27)#32
Merged
Conversation
…ct27)
graphify's GRAPH_REPORT.md equivalent, but live/queryable. New read-only
`tool_report` (src/report.rs) synthesizes three views in one immutable pass:
- hubs ("god-nodes"): top entities by PageRank, in-degree as secondary signal
- surprising_connections: low-prior cross-community edges — bridges between
otherwise-separate Louvain communities, rarer bridges (bridge_rarity) first,
ties broken toward higher-PageRank endpoints
- suggested_questions: deterministic templates seeded by hubs + bridges
Wiring: GET|POST /report (read-only, GET = defaults), quipu_report MCP tool
(24 tools default / 25 with owl), `quipu report` CLI subcommand. Reuses the
existing graph primitives (project/page_rank/in_degree/louvain) — no new deps.
Communities are emergent clustering for surfacing, not an access boundary.
Tests: three-section shape, hub PageRank ordering + in_degree reporting,
bridge-is-the-surprise, determinism across runs, limit handling. fmt + clippy
(default/--no-default-features/--features shacl) + tests all green.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H7b5eTqAZrisQN6NJ4Kn2z
scbrown
added a commit
that referenced
this pull request
Jul 14, 2026
Louvain community detection (#31), live graph report + quipu_report tool (#32), episode-scoped retraction (#33), and --base-ns/--timestamp CLI flags (#34). Manual release: release-plz's release-pr step is blocked by the repo's "Actions may not create PRs" setting (403); cutting the tag + GitHub release by hand per the established fallback. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VsuPDxSUjMYqHvQyPvSAPW
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.
Closes hq-ct27 (aegis-1p0 Gap 4 — backend for the graph-report skill).
What
graphify's static
GRAPH_REPORT.md, but live and queryable. A new read-onlytool_reportsynthesizes three views of the current graph in one immutable pass:in_degreeas asecondary signal
that bridge two otherwise-separate Louvain communities. Rarer bridges
(
bridge_rarity= how many edges cross the same community pair) rank first;ties break toward bridges touching higher-PageRank endpoints
the hubs and bridges above
Plus a
graphsummary (nodes,edges,communities,modularity).Surfaces
GET|POST /report(read-only;GET= defaults,POST= options body)quipu_reportMCP tool — registry now 24 tools default / 25 withowlquipu report [--hubs N] [--surprises N] [--questions N] [--type IRI] [--predicate IRI]CLIReuses existing graph primitives (
project/page_rank/in_degree/louvain) — no new dependencies. Community membership here is emergentclustering for surfacing, not an access boundary (consistent with hq-2u3 / hq-zlph).
Tests
report::tests: three-section shape, hub PageRank ordering + in_degreereporting, bridge-is-the-surprise (
bridge_rarity == 1), determinism acrossruns, limit handling. MCP definition count assertions bumped.
CI hygiene (quipu-strict):
cargo fmt --check,cargo clippy -- -D warnings -A missing-docs(default /--no-default-features/--features shacl), andcargo test(same matrix) all green locally.🤖 Generated with Claude Code