refactor: organize generated/ into benchmarks/ and dogfood/ subdirs (#227)

Move benchmark reports to generated/benchmarks/ and dogfood reports to
generated/dogfood/ for cleaner structure. Update all references:
- benchmark.yml workflow (git diff/add paths)
- 4 report update scripts (output paths + JSDoc)
- README.md benchmark links
- dogfood skill (reference, output, and commit paths)

Author: carlos-alm

.claude/skills/dogfood/SKILL.md

@@ -10,7 +10,7 @@ allowed-tools: Bash, Read, Write, Glob, Grep, Task, Edit
 You are running a comprehensive dogfooding session for codegraph **v$ARGUMENTS**.
 Your goal is to install the published package, exercise every feature, compare engines, find bugs, and produce a structured report.
 
-> **Reference:** Read `generated/DOGFOOD-REPORT-2.1.0.md` and `generated/DOGFOOD_REPORT_v2.2.0.md` (if present) for the format and depth expected. Match or exceed that quality.
+> **Reference:** Read `generated/dogfood/DOGFOOD-REPORT-2.1.0.md` and `generated/dogfood/DOGFOOD_REPORT_v2.2.0.md` (if present) for the format and depth expected. Match or exceed that quality.
 
 ---
 
@@ -190,7 +190,7 @@ If the version does **not** match `$ARGUMENTS`:
 
 1. Run all four from the codegraph source repo directory.
 2. Record the JSON output from each.
-3. Compare with the previous release's numbers in `generated/BUILD-BENCHMARKS.md` (build benchmark) and previous dogfood reports.
+3. Compare with the previous release's numbers in `generated/benchmarks/BUILD-BENCHMARKS.md` (build benchmark) and previous dogfood reports.
 4. Flag any regressions:
    - Build time per file >10% slower → investigate
    - Query latency >2x slower → investigate
@@ -361,7 +361,7 @@ This signals that v$ARGUMENTS has been manually verified end-to-end.
 
 ## Phase 9 — Report
 
-Write the report to `generated/DOGFOOD_REPORT_v$ARGUMENTS.md` with this structure:
+Write the report to `generated/dogfood/DOGFOOD_REPORT_v$ARGUMENTS.md` with this structure:
 
 ```markdown
 # Dogfooding Report: @optave/codegraph@$ARGUMENTS
@@ -450,20 +450,20 @@ The dogfood report **must** be committed to the repository — do not leave it a
 1. **If bug-fix PRs were created during Phase 7:** Add the report to the **first** PR's branch:
    ```bash
    git checkout <first-pr-branch>
-   git add generated/DOGFOOD_REPORT_v$ARGUMENTS.md
+   git add generated/dogfood/DOGFOOD_REPORT_v$ARGUMENTS.md
    git commit -m "docs: add dogfood report for v$ARGUMENTS"
    git push
    ```
 
 2. **If no PRs were created** (zero bugs / green path): Create a dedicated PR for the report:
    ```bash
    git checkout -b docs/dogfood-report-v$ARGUMENTS main
-   git add generated/DOGFOOD_REPORT_v$ARGUMENTS.md
+   git add generated/dogfood/DOGFOOD_REPORT_v$ARGUMENTS.md
    git commit -m "docs: add dogfood report for v$ARGUMENTS"
    git push -u origin docs/dogfood-report-v$ARGUMENTS
    gh pr create --base main \
      --title "docs: add dogfood report for v$ARGUMENTS" \
-     --body "Dogfooding report for v$ARGUMENTS. See generated/DOGFOOD_REPORT_v$ARGUMENTS.md for full details."
+     --body "Dogfooding report for v$ARGUMENTS. See generated/dogfood/DOGFOOD_REPORT_v$ARGUMENTS.md for full details."
    ```
 
 3. **Verify** the report file appears in the PR diff before moving on.

.github/workflows/benchmark.yml

@@ -62,7 +62,7 @@ jobs:
           VERSION_RE="${VERSION//./\\.}"
           if [ "$VERSION" = "dev" ]; then
             echo "skip=false" >> "$GITHUB_OUTPUT"
-          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/BUILD-BENCHMARKS.md 2>/dev/null; then
+          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/benchmarks/BUILD-BENCHMARKS.md 2>/dev/null; then
             echo "Benchmark for $VERSION already exists in BUILD-BENCHMARKS.md — skipping"
             echo "skip=true" >> "$GITHUB_OUTPUT"
           else
@@ -111,11 +111,11 @@ jobs:
         run: |
           CHANGED=false
           # Detect modified tracked files
-          if ! git diff --quiet HEAD -- generated/BUILD-BENCHMARKS.md README.md 2>/dev/null; then
+          if ! git diff --quiet HEAD -- generated/benchmarks/BUILD-BENCHMARKS.md README.md 2>/dev/null; then
             CHANGED=true
           fi
           # Detect newly created (untracked) files
-          if [ -n "$(git ls-files --others --exclude-standard generated/BUILD-BENCHMARKS.md)" ]; then
+          if [ -n "$(git ls-files --others --exclude-standard generated/benchmarks/BUILD-BENCHMARKS.md)" ]; then
             CHANGED=true
           fi
           echo "changed=$CHANGED" >> "$GITHUB_OUTPUT"
@@ -135,7 +135,7 @@ jobs:
             BRANCH="benchmark/build-v${VERSION}-$(date +%Y%m%d-%H%M%S)"
           fi
           git checkout -b "$BRANCH"
-          git add generated/BUILD-BENCHMARKS.md README.md
+          git add generated/benchmarks/BUILD-BENCHMARKS.md README.md
           git commit -m "docs: update build performance benchmarks (${VERSION})"
           git push origin "$BRANCH"
 
@@ -193,7 +193,7 @@ jobs:
           VERSION_RE="${VERSION//./\\.}"
           if [ "$VERSION" = "dev" ]; then
             echo "skip=false" >> "$GITHUB_OUTPUT"
-          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/EMBEDDING-BENCHMARKS.md 2>/dev/null; then
+          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/benchmarks/EMBEDDING-BENCHMARKS.md 2>/dev/null; then
             echo "Benchmark for $VERSION already exists in EMBEDDING-BENCHMARKS.md — skipping"
             echo "skip=true" >> "$GITHUB_OUTPUT"
           else
@@ -256,11 +256,11 @@ jobs:
         run: |
           CHANGED=false
           # Detect modified tracked files
-          if ! git diff --quiet HEAD -- generated/EMBEDDING-BENCHMARKS.md 2>/dev/null; then
+          if ! git diff --quiet HEAD -- generated/benchmarks/EMBEDDING-BENCHMARKS.md 2>/dev/null; then
             CHANGED=true
           fi
           # Detect newly created (untracked) files
-          if [ -n "$(git ls-files --others --exclude-standard generated/EMBEDDING-BENCHMARKS.md)" ]; then
+          if [ -n "$(git ls-files --others --exclude-standard generated/benchmarks/EMBEDDING-BENCHMARKS.md)" ]; then
             CHANGED=true
           fi
           echo "changed=$CHANGED" >> "$GITHUB_OUTPUT"
@@ -280,7 +280,7 @@ jobs:
             BRANCH="benchmark/embedding-v${VERSION}-$(date +%Y%m%d-%H%M%S)"
           fi
           git checkout -b "$BRANCH"
-          git add generated/EMBEDDING-BENCHMARKS.md
+          git add generated/benchmarks/EMBEDDING-BENCHMARKS.md
           git commit -m "docs: update embedding benchmarks (${VERSION})"
           git push origin "$BRANCH"
 
@@ -338,7 +338,7 @@ jobs:
           VERSION_RE="${VERSION//./\\.}"
           if [ "$VERSION" = "dev" ]; then
             echo "skip=false" >> "$GITHUB_OUTPUT"
-          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/QUERY-BENCHMARKS.md 2>/dev/null; then
+          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/benchmarks/QUERY-BENCHMARKS.md 2>/dev/null; then
             echo "Benchmark for $VERSION already exists in QUERY-BENCHMARKS.md — skipping"
             echo "skip=true" >> "$GITHUB_OUTPUT"
           else
@@ -387,11 +387,11 @@ jobs:
         run: |
           CHANGED=false
           # Detect modified tracked files
-          if ! git diff --quiet HEAD -- generated/QUERY-BENCHMARKS.md 2>/dev/null; then
+          if ! git diff --quiet HEAD -- generated/benchmarks/QUERY-BENCHMARKS.md 2>/dev/null; then
             CHANGED=true
           fi
           # Detect newly created (untracked) files
-          if [ -n "$(git ls-files --others --exclude-standard generated/QUERY-BENCHMARKS.md)" ]; then
+          if [ -n "$(git ls-files --others --exclude-standard generated/benchmarks/QUERY-BENCHMARKS.md)" ]; then
             CHANGED=true
           fi
           echo "changed=$CHANGED" >> "$GITHUB_OUTPUT"
@@ -411,7 +411,7 @@ jobs:
             BRANCH="benchmark/query-v${VERSION}-$(date +%Y%m%d-%H%M%S)"
           fi
           git checkout -b "$BRANCH"
-          git add generated/QUERY-BENCHMARKS.md
+          git add generated/benchmarks/QUERY-BENCHMARKS.md
           git commit -m "docs: update query benchmarks (${VERSION})"
           git push origin "$BRANCH"
 
@@ -469,7 +469,7 @@ jobs:
           VERSION_RE="${VERSION//./\\.}"
           if [ "$VERSION" = "dev" ]; then
             echo "skip=false" >> "$GITHUB_OUTPUT"
-          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/INCREMENTAL-BENCHMARKS.md 2>/dev/null; then
+          elif grep -qP '"version":\s*"'"$VERSION_RE"'"' generated/benchmarks/INCREMENTAL-BENCHMARKS.md 2>/dev/null; then
             echo "Benchmark for $VERSION already exists in INCREMENTAL-BENCHMARKS.md — skipping"
             echo "skip=true" >> "$GITHUB_OUTPUT"
           else
@@ -518,11 +518,11 @@ jobs:
         run: |
           CHANGED=false
           # Detect modified tracked files
-          if ! git diff --quiet HEAD -- generated/INCREMENTAL-BENCHMARKS.md 2>/dev/null; then
+          if ! git diff --quiet HEAD -- generated/benchmarks/INCREMENTAL-BENCHMARKS.md 2>/dev/null; then
             CHANGED=true
           fi
           # Detect newly created (untracked) files
-          if [ -n "$(git ls-files --others --exclude-standard generated/INCREMENTAL-BENCHMARKS.md)" ]; then
+          if [ -n "$(git ls-files --others --exclude-standard generated/benchmarks/INCREMENTAL-BENCHMARKS.md)" ]; then
             CHANGED=true
           fi
           echo "changed=$CHANGED" >> "$GITHUB_OUTPUT"
@@ -542,7 +542,7 @@ jobs:
             BRANCH="benchmark/incremental-v${VERSION}-$(date +%Y%m%d-%H%M%S)"
           fi
           git checkout -b "$BRANCH"
-          git add generated/INCREMENTAL-BENCHMARKS.md
+          git add generated/benchmarks/INCREMENTAL-BENCHMARKS.md
           git commit -m "docs: update incremental benchmarks (${VERSION})"
           git push origin "$BRANCH"
 

README.md

@@ -463,7 +463,7 @@ Codegraph also extracts symbols from common callback patterns: Commander `.comma
 
 ## 📊 Performance
 
-Self-measured on every release via CI ([build benchmarks](generated/BUILD-BENCHMARKS.md) | [embedding benchmarks](generated/EMBEDDING-BENCHMARKS.md)):
+Self-measured on every release via CI ([build benchmarks](generated/benchmarks/BUILD-BENCHMARKS.md) | [embedding benchmarks](generated/benchmarks/EMBEDDING-BENCHMARKS.md)):
 
 | Metric | Latest |
 |---|---|