Skip to content

hooks: export-functions.py excludes private functions from docs/functions.txt #1807

@nathanjmcdougall

Description

@nathanjmcdougall

The hooks/export-functions.py script explicitly skips functions whose names start with _ (line 129: if node.name.startswith("_"): continue). This means private helpers such as _get_current_python_version() are not included in docs/functions.txt (and therefore absent from the Function Reference in AGENTS.md).\n\nAgents rely on this reference to discover reusable helpers and avoid reinventing existing logic. If useful private helpers are invisible, agents may duplicate their functionality.\n\nDecision needed: should the hook also export private module-level functions (with a visual indicator), or should the AGENTS.md guidance explicitly note that private helpers are excluded?

Metadata

Metadata

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions