From f936e4bd778185908fedc971b1adfe1bb2b08ea5 Mon Sep 17 00:00:00 2001 From: John Fletcher Date: Mon, 11 Aug 2025 13:37:45 +0200 Subject: [PATCH] Add fixture JSDoc consistency guidelines - Add guidance to maintain identical JSDoc between .input.ts and .expected.ts files - Emphasize keeping @command coordinates referencing input file location - Prevents inconsistency errors during fixture test creation --- guides/COMMAND_IMPLEMENTATION.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/guides/COMMAND_IMPLEMENTATION.md b/guides/COMMAND_IMPLEMENTATION.md index e495d46..df6f453 100644 --- a/guides/COMMAND_IMPLEMENTATION.md +++ b/guides/COMMAND_IMPLEMENTATION.md @@ -240,6 +240,14 @@ tests/fixtures/commands/my-command/ └── error-handling/ ``` +### Fixture Test JSDoc Consistency + +When creating fixture test pairs (`.input.ts` and `.expected.ts`): + +- **Copy JSDoc exactly** from `.input.ts` to `.expected.ts` +- **Keep coordinates unchanged** - `@command` line numbers must reference the `.input.ts` file location +- **Maintain identical content** - all JSDoc metadata must match exactly + ### Unit Tests for Service Logic ```typescript describe('MyDomainService', () => {