src (#447) #457

Open

agent_coder wants to merge 1 commits from fix/447-registry-stamp-ci into develop

Author SHA1 Message Date

Author	SHA1	Message	Date
agent_coder	2e6f1c3de5	fix(ci,mcp): REGISTRY_STAMP в билд-артефакте + кросс-пакетный CI — закрыть skew build/ vs src/ (#447 ) Два структурных слепых пятна: (1) сервер грузит СКОМПИЛИРОВАННЫЙ packages/mcp/build/index.js, а серверные guard-тесты читают src/tool-specs.ts — правка src без пересборки оставляет тесты зелёными, но рантайм расходится со спеками; (2) спеки добавляют в packages/mcp, а parity-тесты живут в jest-сьюте apps/server — PR, трогающий только пакет, проходит зелёным, сломанная in-app- проводка всплывает уже на develop (кейс `f46d89ea`). - REGISTRY_STAMP: codegen (scripts/gen-registry-stamp.mjs) считает sha256 от нормализованного (CRLF→LF, один хвостовой \n снят) сырого текста src/tool-specs.ts, пишет src/registry-stamp.generated.ts (gitignored), index.ts реэкспортит → попадает в build/. Вшит в build/pretest/watch ДО tsc. - Loader (dev/test): computeSrcRegistryStamp пересчитывает стамп из src рядом с build/index.js (dev-vs-prod по existsSync, любая ошибка → null), сверяет с build-стампом → при рассинхроне бросает «build is stale — rebuild». В prod (src нет) и на pre-#447 билдах (нет REGISTRY_STAMP) — чистый no-op. - CI: job mcp-server-parity собирает shared-deps+mcp (регенерит стамп) и гоняет ОБА сьюта вместе (mcp node:test + server guard-спеки) — именованный гейт, его нельзя случайно расщепить. - AGENTS.md: правка спеков требует ребилда @docmost/mcp. Тесты (20): mcp-сайд (детерминизм, нормализация, desync-гард стамп-vs-билд) + server-сайд (null при отсутствии src = prod no-op; mismatch → throw точного сообщения; pre-#447 no-op). Кросс-импл equality-гард: один фиксированный вход → один хэш на ОБЕИХ сторонах, ловит рассинхрон двух нормализаций. Внутреннее ревью: APPROVE WITH SUGGESTIONS (обе — покрытие guard'а — закрыты этим тестом). Мутационно: любой из двух normalize-имплов расходится → equality-тест краснеет. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-07-10 07:58:37 +03:00

agent_coder

2e6f1c3de5

fix(ci,mcp): REGISTRY_STAMP в билд-артефакте + кросс-пакетный CI — закрыть skew build/ vs src/ (#447 )

Два структурных слепых пятна: (1) сервер грузит СКОМПИЛИРОВАННЫЙ
packages/mcp/build/index.js, а серверные guard-тесты читают src/tool-specs.ts —
правка src без пересборки оставляет тесты зелёными, но рантайм расходится со
спеками; (2) спеки добавляют в packages/mcp, а parity-тесты живут в jest-сьюте
apps/server — PR, трогающий только пакет, проходит зелёным, сломанная in-app-
проводка всплывает уже на develop (кейс f46d89ea).

- REGISTRY_STAMP: codegen (scripts/gen-registry-stamp.mjs) считает sha256 от
  нормализованного (CRLF→LF, один хвостовой \n снят) сырого текста
  src/tool-specs.ts, пишет src/registry-stamp.generated.ts (gitignored),
  index.ts реэкспортит → попадает в build/. Вшит в build/pretest/watch ДО tsc.
- Loader (dev/test): computeSrcRegistryStamp пересчитывает стамп из src рядом с
  build/index.js (dev-vs-prod по existsSync, любая ошибка → null), сверяет с
  build-стампом → при рассинхроне бросает «build is stale — rebuild». В prod
  (src нет) и на pre-#447 билдах (нет REGISTRY_STAMP) — чистый no-op.
- CI: job mcp-server-parity собирает shared-deps+mcp (регенерит стамп) и гоняет
  ОБА сьюта вместе (mcp node:test + server guard-спеки) — именованный гейт, его
  нельзя случайно расщепить.
- AGENTS.md: правка спеков требует ребилда @docmost/mcp.

Тесты (20): mcp-сайд (детерминизм, нормализация, desync-гард стамп-vs-билд) +
server-сайд (null при отсутствии src = prod no-op; mismatch → throw точного
сообщения; pre-#447 no-op). Кросс-импл equality-гард: один фиксированный вход →
один хэш на ОБЕИХ сторонах, ловит рассинхрон двух нормализаций. Внутреннее
ревью: APPROVE WITH SUGGESTIONS (обе — покрытие guard'а — закрыты этим тестом).
Мутационно: любой из двух normalize-имплов расходится → equality-тест краснеет.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-10 07:58:37 +03:00

fix(ci,mcp): REGISTRY_STAMP в билде + кросс-пакетный CI — закрыть skew build/vs/src (#447) #457

1 Commits