Skip to content

v0.2.0 — distribution + protocol + producer integrations

Choose a tag to compare

View all tags
@amacsmith amacsmith released this 10 May 11:39
v0.2.0
47593a4

First major iteration since v0.1.0. Same registry shape (schema_version: 1); additive only.

Distribution surface (4 new packages live)

Channel Install
MCP Registry io.github.looptech-ai/understand-quickly (https://registry.modelcontextprotocol.io)
npm CLI npm i -g @looptech-ai/understand-quickly-cli
npm MCP server npm i -g @looptech-ai/understand-quickly-mcp
PyPI SDK pip install understand-quickly
GitHub Action looptech-ai/uq-publish-action@v0.1.0 (Marketplace)

New first-class format

  • bundle@1 for repo-context packers (Repomix, gitingest, codebase-digest, …) — text/markdown bundles via JSON manifest sidecar.

New entry fields (all optional, additive)

  • nodes_count, edges_count, top_kinds[], languages[] — auto-computed at sync.
  • source_sha, head_sha, commits_behind, drift_checked_at — drift detection vs source repo HEAD.
  • revoked status — maintainer-only retraction; agents must skip.

New surfaces shipped

  • CKGP v1 spec — RFC-style protocol doc at docs/spec/code-graph-protocol.md. Multi-vendor: anyone can run their own aggregator.
  • .well-known/code-graph discovery — agents probe a stable URI for graph pointers without going through the registry.
  • Per-entry SVG status badges — embed in upstream READMEs at https://looptech-ai.github.io/understand-quickly/badges/<owner>--<repo>.svg.
  • stats.json — cross-graph aggregate (totals, kinds, languages, concepts) at https://looptech-ai.github.io/understand-quickly/stats.json.
  • MCP tool find_graph_for_repo — agent-ergonomic lookup by GitHub URL.
  • MCP search_concepts wired to stats.json — no fan-out, fast.
  • Sharded read path — entries/<a-z0-9>.json future-proofs scaling.
  • Threat model doc — docs/threat-model.md covering adversarial graphs, dispatch spam, source-repo takeover.
  • Body-size adversarial caps — 50MB, 100k nodes, 500k edges, 4096-char labels, depth 32.
  • Sitemap, JSON-LD, security.txt, privacy — site/SEO polish.

Producer integrations

  • looptech-ai/uq-publish-action@v0.1.0 ships as a Marketplace Action — drops integration PR diff to ~5 lines of YAML.
  • GitNexus PR #1425 MERGED — first upstream tool with native publish support.
  • Open PRs at code-review-graph, deepwiki-open, repomix, gitingest, codebase-digest, graphify, PocketFlow, codebase-memory-mcp, OpenDeepWiki, awesome-mcp-servers (10 awaiting maintainer review).

Pages site

  • Removed overbuilt UX (compare mode, command palette, voice tour, personas, spotlight, path finder, min-degree slider) — reclaimed ~21% LoC.
  • Vendored vis-network locally — no CDN dependency.
  • Cloudflare Web Analytics integration (token-gated, free).
  • Mobile fixes: topbar stacking, sidebar strip, legend collapse, hide-minimap < 700px, label clipping.
  • Desktop tour upgrade: side panel + neighbors + outline + step strip.
  • Playwright smoke tests (chromium + webkit) on PR.

Infra

  • License: Apache 2.0 + Understand-Quickly Data License 1.0.
  • Branch protection on main requiring validate + smoke / chromium + smoke / webkit-iphone.
  • CodeQL scanning weekly + on PR.
  • Dependabot for npm + actions.
  • 235 tests across registry / cli / mcp / python-sdk / Playwright.

Bugs caught + fixed

  • 10 production bugs surfaced in upstream PR sweeps before maintainer review (script injection, dispatch spam, async-blocking, MCP envelope unwrap, scoped-handler leak, server-path leak, wrong-schema, etc).

Community

Breaking

None. schema_version: 1 unchanged. New fields are optional.

Links

Assets 2
Loading