@lenne.tech/cli 1.9.6 → 1.10.0

package/README.md

@@ -55,6 +55,89 @@ $ lt status
 $ lt completion install
 ```
 
+## Framework consumption modes (nest-server)
+
+When you create a new api project (`lt fullstack init` or `lt server create`),
+the CLI supports two framework consumption modes:
+
+**`npm` mode (default)** — `@lenne.tech/nest-server` is installed as an npm
+dependency. Framework source lives in `node_modules/@lenne.tech/nest-server/`.
+Imports use the bare specifier `from '@lenne.tech/nest-server'`. Update path:
+`/lt-dev:backend:update-nest-server` (Claude Code agent).
+
+**`vendor` mode** — The framework's `core/` directory is copied directly into
+`<api>/src/core/` as first-class project code. No `@lenne.tech/nest-server`
+npm dependency. Generated imports use relative paths (`from '../../../core'`).
+Local patches are allowed and tracked in `src/core/VENDOR.md`. Update path:
+`/lt-dev:backend:update-nest-server-core` (Claude Code agent).
+
+### Creating projects
+
+```bash
+# npm mode (classic, default)
+$ lt fullstack init --name myapp --frontend nuxt --api-mode Rest
+
+# vendor mode, HEAD of upstream
+$ lt fullstack init --name myapp --frontend nuxt --api-mode Rest \
+    --framework-mode vendor
+
+# vendor mode, pinned to a specific upstream branch or tag
+$ lt fullstack init --name myapp --framework-mode vendor \
+    --framework-upstream-branch 11.24.1
+
+# dry-run: print the plan without touching the filesystem
+$ lt fullstack init --name myapp --framework-mode vendor --dry-run --noConfirm
+
+# standalone api project (vendor mode works here too)
+$ lt server create --name myapp --framework-mode vendor
+```
+
+### Working on an existing project
+
+All `lt server …` commands (module, object, addProp, test, permissions)
+**auto-detect** the framework mode via `src/core/VENDOR.md` and generate
+the correct import syntax automatically. You never pass `--framework-mode`
+after `init`; it is persisted in the project's `lt.config.json`.
+
+```bash
+# inside projects/api — generates relative or bare imports automatically
+$ lt server module --name Product --controller Rest
+
+# shows the mode + project type
+$ lt status
+
+# prints the mode-specific update instructions
+$ lt fullstack update
+```
+
+### Vendor-mode housekeeping
+
+Vendor-mode projects ship three maintenance scripts under `scripts/vendor/`:
+
+| Script | Purpose | Invocation |
+|---|---|---|
+| `check-vendor-freshness.mjs` | Non-blocking warning when upstream has a newer release than the current baseline | `pnpm run check:vendor-freshness` (auto-invoked by `pnpm run check` / `check:fix` / `check:naf`) |
+| `sync-from-upstream.ts` | Diff generator consumed by the `nest-server-core-updater` Claude Code agent | `pnpm run vendor:sync` |
+| `propose-upstream-pr.ts` | Patch-list generator consumed by the `nest-server-core-contributor` agent | `pnpm run vendor:propose-upstream` |
+
+The vendor-mode baseline (upstream version + commit SHA) is recorded in
+`src/core/VENDOR.md`. Log any substantial local patch there so the updater
+agent can classify it at sync time.
+
+### Integration test
+
+A full end-to-end smoke test for all four supported init combinations
+(`npm/Rest`, `vendor/Rest`, `vendor/GraphQL`, `vendor/Both`) ships with the
+CLI:
+
+```bash
+$ pnpm run test:vendor-init
+```
+
+Each scenario runs init → module → object → addProp → test → tsc → build →
+migrate:list and asserts ~30 structural + functional invariants per scenario.
+Run this before releasing a new CLI version to catch upstream drift early.
+
 ## Configuration
 
 The CLI supports project-specific configuration via `lt.config` files. This allows you to set default values for commands, reducing repetitive input.

package/build/commands/fullstack/init.js

@@ -18,7 +18,7 @@ const NewCommand = {
     hidden: false,
     name: 'init',
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
         // Retrieve the tools we need
         const { config, filesystem, frontendHelper, git, helper, parameters, patching, print: { error, info, spin, success }, prompt: { ask, confirm }, server, strings: { kebabCase }, system, } = toolbox;
         // Start timer
@@ -26,7 +26,7 @@ const NewCommand = {
         // Info
         info('Create a new fullstack workspace');
         // Hint for non-interactive callers (e.g. Claude Code)
-        toolbox.tools.nonInteractiveHint('lt fullstack init --name <name> --frontend <nuxt|angular> --api-mode <Rest|GraphQL|Both> --noConfirm');
+        toolbox.tools.nonInteractiveHint('lt fullstack init --name <name> --frontend <nuxt|angular> --api-mode <Rest|GraphQL|Both> --framework-mode <npm|vendor> [--framework-upstream-branch <ref>] [--dry-run] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
@@ -43,12 +43,17 @@ const NewCommand = {
         const configFrontendCopy = (_r = (_q = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _q === void 0 ? void 0 : _q.fullstack) === null || _r === void 0 ? void 0 : _r.frontendCopy;
         const configApiLink = (_t = (_s = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _s === void 0 ? void 0 : _s.fullstack) === null || _t === void 0 ? void 0 : _t.apiLink;
         const configFrontendLink = (_v = (_u = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _u === void 0 ? void 0 : _u.fullstack) === null || _v === void 0 ? void 0 : _v.frontendLink;
+        const configFrameworkMode = (_x = (_w = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _w === void 0 ? void 0 : _w.fullstack) === null || _x === void 0 ? void 0 : _x.frameworkMode;
         // Parse CLI arguments
-        const { 'api-branch': cliApiBranch, 'api-copy': cliApiCopy, 'api-link': cliApiLink, 'api-mode': cliApiMode, frontend: cliFrontend, 'frontend-branch': cliFrontendBranch, 'frontend-copy': cliFrontendCopy, 'frontend-link': cliFrontendLink, git: cliGit, 'git-link': cliGitLink, name: cliName, } = parameters.options;
+        const { 'api-branch': cliApiBranch, 'api-copy': cliApiCopy, 'api-link': cliApiLink, 'api-mode': cliApiMode, 'dry-run': cliDryRun, 'framework-mode': cliFrameworkMode, 'framework-upstream-branch': cliFrameworkUpstreamBranch, frontend: cliFrontend, 'frontend-branch': cliFrontendBranch, 'frontend-copy': cliFrontendCopy, 'frontend-link': cliFrontendLink, git: cliGit, 'git-link': cliGitLink, name: cliName, } = parameters.options;
+        const dryRun = cliDryRun === true || cliDryRun === 'true';
+        const frameworkUpstreamBranch = typeof cliFrameworkUpstreamBranch === 'string' && cliFrameworkUpstreamBranch.length > 0
+            ? cliFrameworkUpstreamBranch
+            : undefined;
         // Determine noConfirm with priority: CLI > command > parent > global > default
         const noConfirm = config.getNoConfirm({
             cliValue: parameters.options.noConfirm,
-            commandConfig: (_w = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _w === void 0 ? void 0 : _w.fullstack,
+            commandConfig: (_y = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _y === void 0 ? void 0 : _y.fullstack,
             config: ltConfig,
         });
         // Get name of the workspace
@@ -132,6 +137,50 @@ const NewCommand = {
             });
             apiMode = apiModeChoice.apiMode.split(' - ')[0];
         }
+        // Determine framework-consumption mode (npm vs vendored)
+        //
+        //   npm    — classic: @lenne.tech/nest-server is an npm dependency. Framework
+        //            source lives in node_modules/@lenne.tech/nest-server. Backend is
+        //            cloned from nest-server-starter. Updates via
+        //            `/lt-dev:backend:update-nest-server`.
+        //
+        //   vendor — pilot: the framework's core/ directory is copied directly into
+        //            projects/api/src/core/ as first-class project code. No npm
+        //            dependency. Backend is cloned from the nest-server framework repo
+        //            itself and stripped of framework-internal content. Updates via
+        //            `/lt-dev:backend:update-nest-server-core`; local patches are logged
+        //            in src/core/VENDOR.md.
+        //
+        // Default is still 'npm' until the vendoring pilot is fully evaluated.
+        let frameworkMode;
+        if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
+            frameworkMode = cliFrameworkMode;
+        }
+        else if (cliFrameworkMode) {
+            error(`Invalid --framework-mode value "${cliFrameworkMode}". Use "npm" or "vendor".`);
+            return;
+        }
+        else if (configFrameworkMode === 'npm' || configFrameworkMode === 'vendor') {
+            frameworkMode = configFrameworkMode;
+            info(`Using framework mode from lt.config: ${frameworkMode}`);
+        }
+        else if (noConfirm) {
+            frameworkMode = 'npm';
+            info('Using default framework mode: npm (noConfirm mode)');
+        }
+        else {
+            const frameworkModeChoice = yield ask({
+                choices: [
+                    'npm    - @lenne.tech/nest-server as npm dependency (classic, stable)',
+                    'vendor - framework core vendored into projects/api/src/core/ (pilot, allows local patches)',
+                ],
+                initial: 0,
+                message: 'Framework consumption mode?',
+                name: 'frameworkMode',
+                type: 'select',
+            });
+            frameworkMode = frameworkModeChoice.frameworkMode.startsWith('vendor') ? 'vendor' : 'npm';
+        }
         // Determine remote push settings with priority: CLI > config > interactive
         // Git is always initialized; the question is whether to push to a remote
         let pushToRemote = false;
@@ -190,6 +239,53 @@ const NewCommand = {
         const apiLink = cliApiLink || configApiLink;
         const frontendCopy = cliFrontendCopy || configFrontendCopy;
         const frontendLink = cliFrontendLink || configFrontendLink;
+        // Dry-run mode: print the resolved plan and exit without any disk
+        // changes. Useful for CI previews, for Claude Code confirmation
+        // steps, and for debugging the mode-detection logic without
+        // committing to a multi-minute init flow.
+        if (dryRun) {
+            info('');
+            info('Dry-run plan:');
+            info(`  name:                       ${name}`);
+            info(`  projectDir:                 ${projectDir}`);
+            info(`  frontend:                   ${frontend}`);
+            info(`  apiMode:                    ${apiMode}`);
+            info(`  frameworkMode:              ${frameworkMode}`);
+            if (frameworkUpstreamBranch) {
+                info(`  frameworkUpstreamBranch:    ${frameworkUpstreamBranch}`);
+            }
+            info(`  apiBranch:                  ${apiBranch || '(default)'}`);
+            info(`  frontendBranch:             ${frontendBranch || '(default)'}`);
+            info(`  apiCopy:                    ${apiCopy || '(none)'}`);
+            info(`  apiLink:                    ${apiLink || '(none)'}`);
+            info(`  frontendCopy:               ${frontendCopy || '(none)'}`);
+            info(`  frontendLink:               ${frontendLink || '(none)'}`);
+            info(`  pushToRemote:               ${pushToRemote}`);
+            if (pushToRemote) {
+                info(`  gitLink:                    ${gitLink || '(unset — would abort at run-time)'}`);
+            }
+            info('');
+            info('Would execute:');
+            info(`  1. git clone lt-monorepo → ${projectDir}/`);
+            info(`  2. setup frontend (${frontend}) → ${projectDir}/projects/app`);
+            if (frameworkMode === 'vendor') {
+                info(`  3. clone nest-server-starter → ${projectDir}/projects/api`);
+                info(`  4. clone @lenne.tech/nest-server${frameworkUpstreamBranch ? ` (branch/tag: ${frameworkUpstreamBranch})` : ''} → /tmp`);
+                info(`  5. vendor core/ + flatten-fix + codemod consumer imports`);
+                info(`  6. merge upstream deps (dynamic, no hard-coded list)`);
+                info(`  7. run processApiMode(${apiMode})`);
+                if (apiMode === 'Rest') {
+                    info(`  8. restore vendored core essentials (graphql-*)`);
+                }
+            }
+            else {
+                info(`  3. clone nest-server-starter → ${projectDir}/projects/api`);
+                info(`  4. run processApiMode(${apiMode})`);
+            }
+            info('  N. pnpm install + initial git commit');
+            info('');
+            return `fullstack init dry-run (${frameworkMode} / ${apiMode})`;
+        }
         const workspaceSpinner = spin(`Create fullstack workspace with ${frontend} in ${projectDir} with ${name} app`);
         // Clone monorepo
         try {
@@ -217,6 +313,7 @@ const NewCommand = {
                 .replace(/\{\{PROJECT_NAME\}\}/g, () => name)
                 .replace(/\{\{PROJECT_DIR\}\}/g, () => projectDir)
                 .replace(/\{\{API_MODE\}\}/g, () => apiMode)
+                .replace(/\{\{FRAMEWORK_MODE\}\}/g, () => frameworkMode)
                 .replace(/\{\{FRONTEND_FRAMEWORK\}\}/g, () => frontendName));
         }
         // Always initialize git
@@ -280,6 +377,8 @@ const NewCommand = {
                 apiMode,
                 branch: apiBranch,
                 copyPath: apiCopy,
+                frameworkMode,
+                frameworkUpstreamBranch,
                 linkPath: apiLink,
                 name,
                 projectDir,
@@ -289,6 +388,10 @@ const NewCommand = {
                 return;
             }
             // Create lt.config.json for API
+            // Note: frameworkMode is persisted under meta so that subsequent `lt
+            // server module` / `addProp` / `permissions` calls can detect the mode
+            // without re-probing src/core/VENDOR.md each time (the VENDOR.md check
+            // still works; this is just an explicit marker).
             const apiConfigPath = filesystem.path(apiDest, 'lt.config.json');
             filesystem.write(apiConfigPath, {
                 commands: {
@@ -300,6 +403,7 @@ const NewCommand = {
                 },
                 meta: {
                     apiMode,
+                    frameworkMode,
                     version: '1.0.0',
                 },
             }, { jsonIndent: 2 });

package/build/commands/fullstack/update.js

@@ -0,0 +1,129 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = require("path");
+const framework_detection_1 = require("../../lib/framework-detection");
+/**
+ * Update a fullstack workspace — mode-aware.
+ *
+ * lenne.tech fullstack projects currently run in one of two framework
+ * consumption modes:
+ *
+ *   - npm mode:    `@lenne.tech/nest-server` is an npm dependency. Updates
+ *                  happen via `pnpm update @lenne.tech/nest-server` plus
+ *                  the migration guides, orchestrated by the
+ *                  `lt-dev:nest-server-updater` Claude Code agent.
+ *
+ *   - vendor mode: The framework `core/` tree is vendored into
+ *                  `projects/api/src/core/`. Updates happen via the
+ *                  `lt-dev:nest-server-core-updater` Claude Code agent,
+ *                  which clones the upstream repo, computes a delta,
+ *                  applies the approved hunks, and re-runs the flatten-fix.
+ *
+ * Detection is based on the presence of `src/core/VENDOR.md` in the api
+ * project. This command prints the right instructions for the caller's
+ * project; actual update orchestration lives in the Claude Code agents,
+ * not in the CLI.
+ */
+const NewCommand = {
+    alias: ['up', 'upd'],
+    description: 'Show the mode-specific update instructions for this fullstack workspace',
+    hidden: false,
+    name: 'update',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        const { filesystem, print: { colors, info, success, warning }, } = toolbox;
+        info('');
+        info(colors.bold('Fullstack Update'));
+        info(colors.dim('─'.repeat(60)));
+        // Walk from cwd DOWN into projects/api if it exists, otherwise assume
+        // the caller is already inside an api project. Users can also point at
+        // a specific directory via `--api <path>`.
+        const cwd = filesystem.cwd();
+        const candidates = [
+            toolbox.parameters.options.api ? String(toolbox.parameters.options.api) : null,
+            (0, path_1.join)(cwd, 'projects', 'api'),
+            (0, path_1.join)(cwd, 'packages', 'api'),
+            cwd,
+        ].filter((p) => Boolean(p));
+        let apiDir;
+        for (const candidate of candidates) {
+            if (filesystem.exists((0, path_1.join)(candidate, 'package.json'))) {
+                apiDir = candidate;
+                break;
+            }
+        }
+        if (!apiDir) {
+            warning('  Could not locate an api project (no package.json found in cwd or projects/api/).');
+            info('');
+            info('  Pass --api <path> to point at the api project explicitly.');
+            info('');
+            return;
+        }
+        const mode = (0, framework_detection_1.detectFrameworkMode)(apiDir);
+        const vendored = (0, framework_detection_1.isVendoredProject)(apiDir);
+        info(`  API project: ${apiDir}`);
+        info(`  Framework mode: ${mode}${vendored ? ' (src/core/VENDOR.md present)' : ''}`);
+        info('');
+        if (mode === 'vendor') {
+            info(colors.bold('Vendor-mode update flow:'));
+            info('');
+            info('  The framework core/ tree lives directly in this project at');
+            info('    src/core/');
+            info('  and is managed as first-class project code. Local patches are');
+            info('  allowed and tracked in src/core/VENDOR.md.');
+            info('');
+            info(colors.bold('  Recommended update commands:'));
+            info('');
+            info('    1. Refresh the upstream baseline + check for new versions');
+            info(`       ${colors.cyan('(run from the api project)')}`);
+            info('');
+            info('       /lt-dev:backend:update-nest-server-core');
+            info('');
+            info('    2. After the updater completes, run a freshness check:');
+            info('');
+            info('       pnpm run check:vendor-freshness');
+            info('');
+            info('    3. If local changes have become generally useful, propose');
+            info('       them as upstream PRs via:');
+            info('');
+            info('       /lt-dev:backend:contribute-nest-server-core');
+            info('');
+            success('  All of these operate on src/core/ in-place; no npm dep bump.');
+        }
+        else {
+            info(colors.bold('npm-mode update flow:'));
+            info('');
+            info('  The framework lives in node_modules/@lenne.tech/nest-server as');
+            info('  a pinned npm dependency.');
+            info('');
+            info(colors.bold('  Recommended update commands:'));
+            info('');
+            info('    1. Run the nest-server-updater agent:');
+            info('');
+            info('       /lt-dev:backend:update-nest-server');
+            info('');
+            info('       (or manually: pnpm update @lenne.tech/nest-server');
+            info('        and walk the migration guides)');
+            info('');
+            info('    2. After upgrade, run the full check suite:');
+            info('');
+            info('       pnpm run check');
+            info('');
+            success('  The nest-server-updater agent auto-detects vendor projects');
+            success('  and delegates to nest-server-core-updater when VENDOR.md is present.');
+        }
+        info('');
+        info(colors.dim('─'.repeat(60)));
+        info('');
+        return `fullstack update (${mode} mode)`;
+    }),
+};
+exports.default = NewCommand;

package/build/commands/server/add-property.js

@@ -14,6 +14,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
 const ts_morph_1 = require("ts-morph");
+const framework_detection_1 = require("../../lib/framework-detection");
 const module_1 = __importDefault(require("./module"));
 const object_1 = __importDefault(require("./object"));
 /**
@@ -427,8 +428,34 @@ const NewCommand = {
                     const mappingPairs = Object.entries(mappings).map(([k, v]) => `${k}: ${v}`);
                     returnStatement.replaceWithText(`return mapClasses(input, { ${mappingPairs.join(', ')} }, this);`);
                 }
-                // Ensure mapClasses is imported
-                const existingImports = moduleFile.getImportDeclaration('@lenne.tech/nest-server');
+                // Ensure mapClasses is imported. The import specifier differs by
+                // framework-consumption mode — in npm projects it's
+                // '@lenne.tech/nest-server'; in vendored projects it's a relative
+                // path to src/core whose depth depends on the model file location.
+                // We search for BOTH forms so this works regardless of how the file
+                // was originally generated.
+                const vendoredSpec = (0, framework_detection_1.isVendoredProject)(path)
+                    ? (0, framework_detection_1.getFrameworkImportSpecifier)(path, modelPath)
+                    : null;
+                let existingImports = moduleFile.getImportDeclaration('@lenne.tech/nest-server');
+                if (!existingImports && vendoredSpec) {
+                    existingImports = moduleFile.getImportDeclaration(vendoredSpec);
+                }
+                if (!existingImports) {
+                    // Final fallback: scan all imports and match any that resolves to
+                    // the framework path (covers hand-edited files or unusual depths).
+                    const allImports = moduleFile.getImportDeclarations();
+                    existingImports = allImports.find((imp) => {
+                        const spec = imp.getModuleSpecifierValue();
+                        if (spec === '@lenne.tech/nest-server')
+                            return true;
+                        if (!vendoredSpec)
+                            return false;
+                        // Accept any relative path ending with '/core' or '../core' —
+                        // covers variations across file depths.
+                        return /(^|\/)core(\/.*)?$/.test(spec) && spec.startsWith('.');
+                    });
+                }
                 if (existingImports) {
                     const namedImports = existingImports.getNamedImports();
                     const hasMapClasses = namedImports.some((ni) => ni.getName() === 'mapClasses');

package/build/commands/server/create.js

@@ -18,7 +18,7 @@ const NewCommand = {
     hidden: false,
     name: 'create',
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
         // Retrieve the tools we need
         const { config, filesystem, git, helper, meta, parameters, print: { error, info, spin, success }, prompt: { ask, confirm }, server, strings: { kebabCase }, system, } = toolbox;
         // Handle --help-json flag
@@ -62,6 +62,7 @@ const NewCommand = {
         const configCopy = (_q = (_p = (_o = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _o === void 0 ? void 0 : _o.server) === null || _p === void 0 ? void 0 : _p.create) === null || _q === void 0 ? void 0 : _q.copy;
         const configLink = (_t = (_s = (_r = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _r === void 0 ? void 0 : _r.server) === null || _s === void 0 ? void 0 : _s.create) === null || _t === void 0 ? void 0 : _t.link;
         const configApiMode = (_w = (_v = (_u = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _u === void 0 ? void 0 : _u.server) === null || _v === void 0 ? void 0 : _v.create) === null || _w === void 0 ? void 0 : _w.apiMode;
+        const configFrameworkMode = (_z = (_y = (_x = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _x === void 0 ? void 0 : _x.server) === null || _y === void 0 ? void 0 : _y.create) === null || _z === void 0 ? void 0 : _z.frameworkMode;
         // Load global defaults
         const globalAuthor = config.getGlobalDefault(ltConfig, 'author');
         const globalApiMode = config.getGlobalDefault(ltConfig, 'apiMode');
@@ -74,10 +75,12 @@ const NewCommand = {
         const cliCopy = parameters.options.copy || parameters.options.c;
         const cliLink = parameters.options.link;
         const cliApiMode = parameters.options['api-mode'] || parameters.options.apiMode;
+        const cliFrameworkMode = parameters.options['framework-mode'];
+        const cliFrameworkUpstreamBranch = parameters.options['framework-upstream-branch'];
         // Determine noConfirm with priority: CLI > config > global > default (false)
         const noConfirm = config.getNoConfirm({
             cliValue: cliNoConfirm,
-            commandConfig: (_y = (_x = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _x === void 0 ? void 0 : _x.server) === null || _y === void 0 ? void 0 : _y.create,
+            commandConfig: (_1 = (_0 = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _0 === void 0 ? void 0 : _0.server) === null || _1 === void 0 ? void 0 : _1.create,
             config: ltConfig,
         });
         // Start timer
@@ -178,6 +181,39 @@ const NewCommand = {
             ]);
             apiMode = apiModeChoice.apiMode.split(' - ')[0];
         }
+        // Determine framework consumption mode — same resolution cascade as
+        // lt fullstack init: CLI flag > lt.config > interactive (default npm).
+        let frameworkMode;
+        if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
+            frameworkMode = cliFrameworkMode;
+        }
+        else if (cliFrameworkMode) {
+            error(`Invalid --framework-mode value "${cliFrameworkMode}". Use "npm" or "vendor".`);
+            return;
+        }
+        else if (configFrameworkMode === 'npm' || configFrameworkMode === 'vendor') {
+            frameworkMode = configFrameworkMode;
+            info(`Using framework mode from lt.config: ${frameworkMode}`);
+        }
+        else if (noConfirm) {
+            frameworkMode = 'npm';
+        }
+        else {
+            const frameworkModeChoice = yield ask({
+                choices: [
+                    'npm    - @lenne.tech/nest-server as npm dependency (classic, stable)',
+                    'vendor - framework core vendored into src/core/ (pilot, allows local patches)',
+                ],
+                initial: 0,
+                message: 'Framework consumption mode?',
+                name: 'frameworkMode',
+                type: 'select',
+            });
+            frameworkMode = frameworkModeChoice.frameworkMode.startsWith('vendor') ? 'vendor' : 'npm';
+        }
+        const frameworkUpstreamBranch = typeof cliFrameworkUpstreamBranch === 'string' && cliFrameworkUpstreamBranch.length > 0
+            ? cliFrameworkUpstreamBranch
+            : undefined;
         // Setup server using Server extension
         const setupSpinner = spin(`Setting up server${linkPath ? ' (link)' : copyPath ? ' (copy)' : branch ? ` (branch: ${branch})` : ''}`);
         const result = yield server.setupServer(`./${projectDir}`, {
@@ -186,6 +222,8 @@ const NewCommand = {
             branch,
             copyPath,
             description,
+            frameworkMode,
+            frameworkUpstreamBranch,
             linkPath,
             name,
             projectDir,
@@ -213,7 +251,7 @@ const NewCommand = {
         }
         // Git initialization (after npm install which is done in setupServer)
         if (git) {
-            const inGit = (_z = (yield system.run('git rev-parse --is-inside-work-tree'))) === null || _z === void 0 ? void 0 : _z.trim();
+            const inGit = (_2 = (yield system.run('git rev-parse --is-inside-work-tree'))) === null || _2 === void 0 ? void 0 : _2.trim();
             if (inGit !== 'true') {
                 // Determine initGit with priority: CLI > config > interactive
                 let initializeGit;