// Modify TypeScript generator internals, OpenAPI parsing/schema handling, and generated file writing behavior without regressing regeneration guarantees.
| name | counterfact-generator-internals |
| description | Modify TypeScript generator internals, OpenAPI parsing/schema handling, and generated file writing behavior without regressing regeneration guarantees. |
| applyTo | ["src/typescript-generator/**/*.ts","src/server/openapi-document.ts","src/server/load-openapi-document.ts","test/typescript-generator/**/*.test.ts"] |
Use this skill when changing OpenAPI loading/bundling, schema-to-type generation, operation/type coders, repository/script writing, or generated versions typing.
src/typescript-generator/README.mdsrc/typescript-generator/code-generator.tssrc/typescript-generator/specification.tssrc/typescript-generator/requirement.tssrc/typescript-generator/repository.tssrc/typescript-generator/schema-type-coder.tsSpecification/Requirement -> coders -> Script -> Repository.Repository.writeFiles.types/versions.ts per group).yarn lint, yarn build, yarn test.test/typescript-generator/).docs/reference.md, docs/faq.md).Keep contributor changes aligned with repository test patterns, diagnostics, release/versioning workflow, documentation requirements, and compatibility.
Provide Counterfact repository orientation, high-level architecture, and the canonical command reference for install/build/test/lint workflows.
Update Counterfact CLI option behavior, config resolution, telemetry-safe startup handling, and bootstrap/runtime entrypoint flow.
Safely change Counterfact runtime/server internals while preserving module boundaries, hot reload behavior, and backward compatibility guarantees.
Add and evolve Counterfact context classes in _.context.ts files, including required unit test coverage for context behavior.
Edit Counterfact route files to add endpoint behavior while keeping handlers thin and delegating business logic to context classes.