Vendored nest-server core Knowledge Base

Gotchas

• Flatten-fix edge case on core-persistence-model.interface.ts — During flatten-fix, most files get '../../..' rewritten to '../..'. This file is an exception: it sits one directory deeper and needs '../../..' → '../..' → '..'. Missing this step causes a silent Cannot find module at runtime, not compile-time.
• migrate CLI disappears after vendoring — The upstream @lenne.tech/nest-server package exports a migrate binary in its package.json. When vendored (no longer a dependency), that binary is gone from node_modules/.bin/. convert-mode copies bin/migrate.js into the project and repoints the migrate:* scripts at it. See "The migrate CLI in a Vendored Project" below — and note that the production path (compiled JS) differs from the local path (TypeScript loaded at run time), which is how migrations end up silently never running in the container.
• Cosmetic commits are tempting upstream PR candidates — Formatting-only, linting-only, or rename-only commits look substantive but offer no value as upstream PRs. The contributor agent filters these — if authoring manually, verify the commit changes behavior, not just style.
• Local patches in src/core/ are invisible to future /lt-dev:backend:update-nest-server-core runs — The updater does AI-driven curation but cannot read your intent. Document every intentional local deviation in src/core/LOCAL-PATCHES.md so the next sync doesn't silently undo your work.

This skill provides knowledge and resources for lenne.tech projects that have vendored the @lenne.tech/nest-server core into their source tree. For automated execution, use the matching agents:

• lt-dev:nest-server-core-updater via /lt-dev:backend:update-nest-server-core — pulls upstream changes into the vendored core, with AI-driven curation against local patches
• lt-dev:nest-server-core-contributor via /lt-dev:backend:contribute-nest-server-core — identifies substantial local changes to the vendored core and prepares them as Upstream-Pull-Requests to the nest-server repository