Repository navigation
feat(graphify-plugin): add Graphify knowledge-graph skill plugin - #171
Open
tahatehran wants to merge 2 commits into
Open
tahatehran wants to merge 2 commits into
tahatehran wants to merge 2 commits into
Conversation
Graphify scans a codebase (code, docs, configs) into a queryable knowledge graph and ships three artifacts under <target>/.graphify/: graph.json (9 query commands), a self-contained interactive graph.html, and a markdown report. Stdlib-only Python 3.8+, no network access, output paths containment-checked. Includes README.md + README_CN.md, sample fixture and end-to-end smoke test.
Collaborator
|
✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically. |
Author
|
Local baseline update (Windows machine) — verification receipts:
|
Collaborator
|
❌ Internal validation failed: Please fix it and push again; the check re-runs automatically. 🤖 Copy this prompt into Claude Code / Codex to fix it |
This branch has not been deployed
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.
Plugin type (required) / 插件类型(必填)
Affected plugin name(s) / 涉及的插件名称:
graphify-pluginWhat / 改动内容
EN: Adds Graphify (
external_plugins/graphify-plugin/), a knowledge-graph skill plugin. It scans a project directory (code, docs, config files), extracts files, symbols, imports and doc references, and produces three artifacts under<target>/.graphify/:graph.json(queryable via 9 commands inquery_graph.py), a self-contained interactivegraph.html(no CDN), andgraph-report.md(hubs, orphan/dead code, external deps, broken doc links). The agent then answers structural questions from the graph instead of re-reading the repo.中文: 新增 Graphify 插件(
external_plugins/graphify-plugin/):将代码库转换为可查询的知识图谱。扫描代码、文档与配置文件,提取文件、符号、import 与文档引用,在<target>/.graphify/下生成三个产物:可查询的graph.json(query_graph.py提供 9 个查询命令)、自包含的交互式graph.html(无 CDN)与graph-report.md(枢纽文件、孤立/死代码、外部依赖、失效文档链接)。智能体据此回答结构性问题,无需反复阅读整个仓库。Testing / 测试
tests/validate.py(structure) +tests/smoke_test.py(end-to-end build+query on a fixture with Python/JS/docs/config).python scripts/validate.py→OK: 53 plugin(s) validated;git diff --checkclean.python scripts/build_dist.pycould not complete locally: UI-plugin builds require the pnpm toolchain (Node ≥ 24 perpackage.jsonengines; local env has Node 22 and two registry downloads were cut by network resets). The failure occurs onexcalidraw— pre-existing on upstreammainwithout UI builds, unrelated to this stdlib-only plugin. Please let CI exercise it.Dependencies / network / permissions / side effects
py -3). Scripts are stdlib-only: no pip installs, no third-party code, no assets, no network access at runtime.<scanned-target>/.graphify/(graph.json,graph.html,graph-report.md); output paths are containment-checked (realpath+commonpath) and cannot escape the output directory.Licensing / provenance
Marketplace registration
external_plugins/graphify-plugin/marketplace.jsonentry added with matching name/version/description (graphify-plugin@0.1.0), categorydeveloper-tools.Self-check / 自查清单
external_plugins/graphify-plugin/; existing fixes retain ownershipcategoryis set independently of publisher ownership (developer-tools).zcode-plugin/plugin.jsonhasname,description,description_i18n,version,author; matches the marketplace entryREADME.mdandREADME_CN.mdare present; side effects documented in bothvalidate.pyandgit diff --checkpass locally;build_dist.pynoted above (local toolchain gap, pre-existing)