feat: Add relationship graph extraction for LLM consumption

Generate per-product relationship JSON files to static/relations/ that
map class inheritance, trait usage, dependencies, instantiation, and
static calls between symbols. This enables LLMs to understand codebase
architecture without direct code access.

- Add extract-relations.php (PHP tokenizer-based extractor)
- Add generate-relations.mjs (Node.js runner script)
- Add relations:generate npm script
- Update docs:generate to include relations step
- Update deploy.yml workflow to run relations generation
- Add static/relations/ to .gitignore

Author: zackkatz

.github/workflows/deploy.yml

@@ -51,6 +51,9 @@ jobs:
       - name: Generate hooks documentation
         run: npm run docs:generate
 
+      - name: Generate relationship graphs for LLMs
+        run: npm run relations:generate
+
       - name: Enhance documentation for LLMs
         run: npm run llm:enhance
 

.gitignore

@@ -13,6 +13,9 @@ static/api/
 static/llms.txt
 static/docs/
 
+# Generated relationship graphs (built by npm run relations:generate)
+static/relations/
+
 # Generated hooks config (built by npm run hooks:generate)
 wp-hooks-doc.json
 

package.json

@@ -18,7 +18,8 @@
     "hooks:generate": "node ./scripts/generate-hooks.mjs",
     "hooks:link-api-types": "node ./scripts/link-hooks-to-api.mjs",
     "api:generate": "node ./scripts/generate-php-api.mjs",
-    "docs:generate": "npm run hooks:generate && npm run api:generate && npm run hooks:link-api-types && node ./scripts/generate-category-indexes.mjs",
+    "relations:generate": "node ./scripts/generate-relations.mjs",
+    "docs:generate": "npm run hooks:generate && npm run api:generate && npm run relations:generate && npm run hooks:link-api-types && node ./scripts/generate-category-indexes.mjs",
     "llm:enhance": "node ./scripts/enhance-for-llms.mjs && node ./scripts/generate-product-llms.mjs",
     "llm:product": "node ./scripts/generate-product-llms.mjs",
     "docs:full": "npm run repos:clone && npm run docs:generate && npm run llm:enhance && npm run build"