api-reference

API Reference (v2)

Generates .codeanalyzer/reports/phase4/api-reference.md by bulk-extracting public APIs via Cypher.

Data collection

MATCH (c:Class)-[:DEFINES]->(m:Member)
WHERE m.visibility IN ['public','protected']
  AND NOT m.attribute CONTAINS 'internal'
RETURN c.name, c.file, m.name, m.signature, m.docstring, m.visibility
ORDER BY c.name, m.visibility, m.name

For C++, also query free functions in headers:

MATCH (f:Function)
WHERE f.file =~ '.*\\.(h|hpp|hxx)$' AND f.exported = true
RETURN f.name, f.signature, f.docstring, f.file

Output structure

# API Reference

## <ClassName> (<file path>)
<class-level docstring from Cypher>

### Public members
| Visibility | Signature | Notes |

### Protected members
| Visibility | Signature | Notes |

## Free functions
| Signature | File | Notes |

Rules

• Zero LLM inference on signatures / types — Cypher output is truth.
• LLM only augments Notes column (1 line max per entry), using the member's mirror doc if present.
• All public APIs must appear — no sampling. If the export set > 500 entries, split into multiple files api-reference.md, api-reference-2.md etc.