Add or update PerfectHash generated file outputs (file work entries, prepare/save callbacks, CMake/VCXProj registration, and tests) when new output files or artifacts need to be added.
Content & Writing
86 Stars
15 Forks
Updated Jan 19, 2026, 04:20 AM
Why Use This
This skill provides specialized capabilities for tpn's codebase.
Use Cases
Developing new features in the tpn repository
Refactoring existing code to follow tpn standards
Understanding and working with tpn's codebase structure
---
name: add-new-file
description: Add or update PerfectHash generated file outputs (file work entries, prepare/save callbacks, CMake/VCXProj registration, and tests) when new output files or artifacts need to be added.
---
# Add New Generated File
## Workflow
- Add a new entry to `src/PerfectHash/PerfectHashFileWork.h` in `VERB_FILE_WORK_TABLE` with the right suffix/extension/EOF init; keep ordering invariants (streams follow owning files, VC project entries stay contiguous, context files stay contiguous).
- Implement prepare/save callbacks in `src/PerfectHash/Chm01FileWork*.c`. If a stage is intentionally unused, set `PrepareXxxChm01` or `SaveXxxChm01` to `NULL` in `src/PerfectHash/Chm01FileWork.h`.
- If a new file extension is needed, add a `UNICODE_STRING` in `src/PerfectHash/PerfectHashConstants.c` and wire it into the file work entry.
- Register new sources in `src/PerfectHash/CMakeLists.txt`; mirror additions in `src/PerfectHash/PerfectHash.vcxproj` and `src/PerfectHash/PerfectHash.vcxproj.filters`.
- Update `src/PerfectHash/Chm01FileWork.c` path logic when a file needs custom base names, directories, or stream rules.
- Update generators/tests (`src/PerfectHash/Chm01FileWorkCMakeListsTextFile.c`, `tests/run_cli_codegen_test.cmake`, etc.) if the new file needs build/test coverage.
- Add or expand tests to write the new files and compile/run them.
## File Enum Capacity
- When the 64-bit bitmap for file enums is exhausted, add a new enum group with `_2`, `_3`, etc. suffix and preserve existing ordering rules.
