@lenne.tech/cli 1.10.0 → 1.11.0

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, _x, _y;
+        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;
         // 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
@@ -45,7 +45,7 @@ const NewCommand = {
         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, '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 { '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-framework-mode': cliFrontendFrameworkMode, '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
@@ -181,6 +181,27 @@ const NewCommand = {
             });
             frameworkMode = frameworkModeChoice.frameworkMode.startsWith('vendor') ? 'vendor' : 'npm';
         }
+        // ── Frontend framework mode ─────────────────────────────────────────
+        const configFrontendFrameworkMode = (_0 = (_z = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _z === void 0 ? void 0 : _z.fullstack) === null || _0 === void 0 ? void 0 : _0.frontendFrameworkMode;
+        let frontendFrameworkMode;
+        if (cliFrontendFrameworkMode === 'npm' || cliFrontendFrameworkMode === 'vendor') {
+            frontendFrameworkMode = cliFrontendFrameworkMode;
+        }
+        else if (cliFrontendFrameworkMode) {
+            error(`Invalid --frontend-framework-mode value "${cliFrontendFrameworkMode}". Use "npm" or "vendor".`);
+            return;
+        }
+        else if (configFrontendFrameworkMode === 'npm' || configFrontendFrameworkMode === 'vendor') {
+            frontendFrameworkMode = configFrontendFrameworkMode;
+            info(`Using frontend framework mode from lt.config: ${frontendFrameworkMode}`);
+        }
+        else if (noConfirm) {
+            frontendFrameworkMode = 'npm';
+        }
+        else {
+            // Default to npm without asking (unless user sets it explicitly)
+            frontendFrameworkMode = '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;
@@ -251,6 +272,7 @@ const NewCommand = {
             info(`  frontend:                   ${frontend}`);
             info(`  apiMode:                    ${apiMode}`);
             info(`  frameworkMode:              ${frameworkMode}`);
+            info(`  frontendFrameworkMode:      ${frontendFrameworkMode}`);
             if (frameworkUpstreamBranch) {
                 info(`  frameworkUpstreamBranch:    ${frameworkUpstreamBranch}`);
             }
@@ -282,6 +304,11 @@ const NewCommand = {
                 info(`  3. clone nest-server-starter → ${projectDir}/projects/api`);
                 info(`  4. run processApiMode(${apiMode})`);
             }
+            if (frontendFrameworkMode === 'vendor') {
+                info(`  M1. clone @lenne.tech/nuxt-extensions → /tmp`);
+                info(`  M2. vendor app/core/ (module.ts + runtime/) + codemod consumer imports`);
+                info(`  M3. rewrite nuxt.config.ts module entry`);
+            }
             info('  N. pnpm install + initial git commit');
             info('');
             return `fullstack init dry-run (${frameworkMode} / ${apiMode})`;
@@ -364,6 +391,21 @@ const NewCommand = {
         if (frontendResult.method !== 'link') {
             frontendHelper.patchFrontendEnv(frontendDest, projectDir);
         }
+        // ── Frontend vendoring (if requested) ───────────────────────────────
+        if (isNuxt && frontendFrameworkMode === 'vendor' && frontendResult.method !== 'link') {
+            const vendorSpinner = spin('Converting frontend to vendor mode...');
+            try {
+                yield frontendHelper.convertAppCloneToVendored({
+                    dest: frontendDest,
+                    projectName: name,
+                });
+                vendorSpinner.succeed('Frontend converted to vendor mode (app/core/)');
+            }
+            catch (err) {
+                vendorSpinner.fail(`Frontend vendor conversion failed: ${err.message}`);
+                toolbox.print.warning('Continuing with npm mode for frontend.');
+            }
+        }
         // Remove gitkeep file
         filesystem.remove(`${projectDir}/projects/.gitkeep`);
         // Integrate files

package/build/commands/fullstack/update.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
 const framework_detection_1 = require("../../lib/framework-detection");
+const frontend_framework_detection_1 = require("../../lib/frontend-framework-detection");
 /**
  * Update a fullstack workspace — mode-aware.
  *
@@ -120,10 +121,57 @@ const NewCommand = {
             success('  The nest-server-updater agent auto-detects vendor projects');
             success('  and delegates to nest-server-core-updater when VENDOR.md is present.');
         }
+        // ── Frontend mode-aware instructions ──────────────────────────────
         info('');
         info(colors.dim('─'.repeat(60)));
         info('');
-        return `fullstack update (${mode} mode)`;
+        // Detect frontend project
+        const appCandidates = [
+            (0, path_1.join)(cwd, 'projects', 'app'),
+            (0, path_1.join)(cwd, 'packages', 'app'),
+        ].filter((p) => Boolean(p));
+        let appDir;
+        for (const candidate of appCandidates) {
+            if (filesystem.exists((0, path_1.join)(candidate, 'nuxt.config.ts')) || filesystem.exists((0, path_1.join)(candidate, 'package.json'))) {
+                appDir = candidate;
+                break;
+            }
+        }
+        if (appDir) {
+            const frontendMode = (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(appDir);
+            const frontendVendored = (0, frontend_framework_detection_1.isVendoredAppProject)(appDir);
+            info(`  App project: ${appDir}`);
+            info(`  Frontend framework mode: ${frontendMode}${frontendVendored ? ' (app/core/VENDOR.md present)' : ''}`);
+            info('');
+            if (frontendMode === 'vendor') {
+                info(colors.bold('Frontend vendor-mode update flow:'));
+                info('');
+                info('  The nuxt-extensions module lives directly in this project at');
+                info('    app/core/');
+                info('  and is managed as first-class project code.');
+                info('');
+                info(colors.bold('  Recommended update commands:'));
+                info('');
+                info('    /lt-dev:frontend:update-nuxt-extensions-core');
+                info('');
+            }
+            else {
+                info(colors.bold('Frontend npm-mode update flow:'));
+                info('');
+                info('    /lt-dev:fullstack:update --skip-backend');
+                info('');
+                info('    (or manually: pnpm update @lenne.tech/nuxt-extensions)');
+                info('');
+            }
+        }
+        info('');
+        info(colors.bold('For a comprehensive update of everything, use:'));
+        info('');
+        info('    /lt-dev:fullstack:update-all');
+        info('');
+        info(colors.dim('─'.repeat(60)));
+        info('');
+        return `fullstack update (backend: ${mode}, frontend: ${appDir ? (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(appDir) : 'not found'})`;
     }),
 };
 exports.default = NewCommand;

package/build/commands/server/convert-mode.js

@@ -0,0 +1,197 @@
+"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 framework_detection_1 = require("../../lib/framework-detection");
+/**
+ * Convert an existing API project between npm mode and vendor mode.
+ *
+ * Usage:
+ *   lt server convert-mode --to vendor [--upstream-branch 11.24.2]
+ *   lt server convert-mode --to npm [--version 11.24.2]
+ */
+const ConvertModeCommand = {
+    description: 'Convert API project between npm and vendor framework modes',
+    hidden: false,
+    name: 'convert-mode',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        const { filesystem, parameters, print: { error, info, spin, success, warning }, prompt: { confirm }, server, } = toolbox;
+        // Handle --help-json flag
+        if (toolbox.tools.helpJson({
+            description: 'Convert API project between npm and vendor framework modes',
+            name: 'convert-mode',
+            options: [
+                {
+                    description: 'Target mode',
+                    flag: '--to',
+                    required: true,
+                    type: 'string',
+                    values: ['vendor', 'npm'],
+                },
+                {
+                    description: 'Upstream branch/tag to vendor from (only with --to vendor)',
+                    flag: '--upstream-branch',
+                    required: false,
+                    type: 'string',
+                },
+                {
+                    description: 'nest-server version to install (only with --to npm, default: from VENDOR.md baseline)',
+                    flag: '--version',
+                    required: false,
+                    type: 'string',
+                },
+                {
+                    default: false,
+                    description: 'Skip confirmation prompt',
+                    flag: '--noConfirm',
+                    required: false,
+                    type: 'boolean',
+                },
+                {
+                    default: false,
+                    description: 'Show the resolved plan without making any changes',
+                    flag: '--dry-run',
+                    required: false,
+                    type: 'boolean',
+                },
+            ],
+        })) {
+            return;
+        }
+        const targetMode = parameters.options.to;
+        if (!targetMode || !['npm', 'vendor'].includes(targetMode)) {
+            error('Missing or invalid --to flag. Use: --to vendor  or  --to npm');
+            return;
+        }
+        // Find the API project root
+        const cwd = filesystem.cwd();
+        const projectDir = (0, framework_detection_1.findProjectDir)(cwd);
+        if (!projectDir) {
+            error('Could not find a package.json in the current directory or any parent. Are you inside an API project?');
+            return;
+        }
+        // Detect current mode
+        const currentMode = (0, framework_detection_1.detectFrameworkMode)(projectDir);
+        info(`Detected current mode: ${currentMode}`);
+        if (currentMode === targetMode) {
+            warning(`Project is already in ${targetMode} mode. Nothing to do.`);
+            return;
+        }
+        // Dry-run: print the resolved plan and exit without any disk changes.
+        const dryRun = parameters.options['dry-run'] === true || parameters.options['dry-run'] === 'true';
+        if (dryRun) {
+            info('');
+            info('Dry-run plan:');
+            info(`  projectDir:   ${projectDir}`);
+            info(`  currentMode:  ${currentMode}`);
+            info(`  targetMode:   ${targetMode}`);
+            if (targetMode === 'vendor') {
+                const upstreamBranch = parameters.options['upstream-branch'];
+                info(`  upstreamBranch: ${upstreamBranch || '(auto-detect from package.json)'}`);
+                info('');
+                info('Would execute:');
+                info('  1. Clone @lenne.tech/nest-server → /tmp/lt-vendor-nest-server-*');
+                info('  2. Copy src/core/, src/index.ts, src/core.module.ts, test/, templates/, types/ → src/core/');
+                info('  3. Apply flatten-fix (index.ts, core.module.ts, test.helper.ts)');
+                info('  4. Rewrite consumer imports: @lenne.tech/nest-server → relative paths');
+                info('  5. Merge upstream deps dynamically into package.json');
+                info('  6. Rewrite migrate scripts to use local bin/migrate.js');
+                info('  7. Add check:vendor-freshness script');
+                info('  8. Create src/core/VENDOR.md with baseline metadata');
+                info('  9. Prepend vendor-mode notice to CLAUDE.md');
+            }
+            else {
+                const targetVersion = parameters.options.version;
+                info(`  targetVersion: ${targetVersion || '(from VENDOR.md baseline)'}`);
+                info('');
+                info('Would execute:');
+                info('  1. Read baseline version from src/core/VENDOR.md');
+                info('  2. Warn if local patches exist in VENDOR.md');
+                info('  3. Rewrite consumer imports: relative → @lenne.tech/nest-server');
+                info('  4. Delete src/core/');
+                info('  5. Restore @lenne.tech/nest-server in package.json');
+                info('  6. Restore migrate scripts to node_modules paths');
+                info('  7. Remove vendor artifacts and CLAUDE.md marker');
+            }
+            info('');
+            return `server convert-mode dry-run (${currentMode} → ${targetMode})`;
+        }
+        // Confirm
+        const noConfirm = parameters.options.noConfirm;
+        if (!noConfirm) {
+            const proceed = yield confirm(`Convert project from ${currentMode} mode to ${targetMode} mode?\n` +
+                `  Project: ${projectDir}\n` +
+                `  This will modify package.json, imports, tsconfig, and CLAUDE.md.`);
+            if (!proceed) {
+                info('Aborted.');
+                return;
+            }
+        }
+        // Execute conversion
+        if (targetMode === 'vendor') {
+            // npm → vendor
+            const upstreamBranch = parameters.options['upstream-branch'];
+            // Auto-detect version from current @lenne.tech/nest-server dep
+            let branch = upstreamBranch;
+            if (!branch) {
+                try {
+                    const pkg = filesystem.read(`${projectDir}/package.json`, 'json');
+                    const deps = Object.assign(Object.assign({}, ((pkg === null || pkg === void 0 ? void 0 : pkg.dependencies) || {})), ((pkg === null || pkg === void 0 ? void 0 : pkg.devDependencies) || {}));
+                    const version = deps['@lenne.tech/nest-server'];
+                    if (version) {
+                        // Strip semver range chars (^, ~, >=, etc.) to get the bare version
+                        branch = version.replace(/^[^0-9]*/, '');
+                        info(`Auto-detected @lenne.tech/nest-server version: ${branch}`);
+                    }
+                }
+                catch (_a) {
+                    // Will prompt or use HEAD
+                }
+            }
+            const spinner = spin('Converting to vendor mode...');
+            try {
+                yield server.convertToVendorMode({
+                    dest: projectDir,
+                    upstreamBranch: branch,
+                });
+                spinner.succeed('Converted to vendor mode successfully.');
+                success('\nNext steps:');
+                info('  1. Run: pnpm install');
+                info('  2. Run: pnpm exec tsc --noEmit');
+                info('  3. Run: pnpm test');
+                info('  4. Commit the changes');
+            }
+            catch (err) {
+                spinner.fail(`Conversion failed: ${err.message}`);
+            }
+        }
+        else {
+            // vendor → npm
+            const targetVersion = parameters.options.version;
+            const spinner = spin('Converting to npm mode...');
+            try {
+                yield server.convertToNpmMode({
+                    dest: projectDir,
+                    targetVersion,
+                });
+                spinner.succeed('Converted to npm mode successfully.');
+                success('\nNext steps:');
+                info('  1. Run: pnpm install');
+                info('  2. Run: pnpm exec tsc --noEmit');
+                info('  3. Run: pnpm test');
+                info('  4. Commit the changes');
+            }
+            catch (err) {
+                spinner.fail(`Conversion failed: ${err.message}`);
+            }
+        }
+    }),
+};
+exports.default = ConvertModeCommand;

package/build/commands/status.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
 const framework_detection_1 = require("../lib/framework-detection");
+const frontend_framework_detection_1 = require("../lib/frontend-framework-detection");
 /**
  * Show project status and context
  */
@@ -29,11 +30,13 @@ const StatusCommand = {
         const projectInfo = {
             configFiles: [],
             frameworkMode: null,
+            frontendFrameworkMode: null,
             gitBranch: null,
             gitRoot: null,
             hasGit: false,
             hasLtConfig: false,
             hasPackageJson: false,
+            monorepoSubprojects: [],
             nodeVersion: null,
             npmVersion: null,
             packageName: null,
@@ -70,6 +73,10 @@ const StatusCommand = {
                 }
                 else if (deps['nuxt']) {
                     projectInfo.projectType = 'nuxt';
+                    // Detect frontend framework mode if nuxt-extensions is present
+                    if (deps['@lenne.tech/nuxt-extensions'] || (0, frontend_framework_detection_1.isVendoredAppProject)(cwd)) {
+                        projectInfo.frontendFrameworkMode = (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(cwd);
+                    }
                 }
                 else if (deps['@angular/core']) {
                     projectInfo.projectType = 'angular';
@@ -91,6 +98,52 @@ const StatusCommand = {
                 // Ignore parse errors
             }
         }
+        // Monorepo subproject detection: scan projects/api and projects/app for
+        // framework modes so that `lt status` at the monorepo root surfaces
+        // backend + frontend framework consumption modes even when the root
+        // itself is not a Nest/Nuxt project.
+        const monorepoCandidates = [
+            { kind: 'backend', path: (0, path_1.join)(cwd, 'projects', 'api') },
+            { kind: 'backend', path: (0, path_1.join)(cwd, 'packages', 'api') },
+            { kind: 'frontend', path: (0, path_1.join)(cwd, 'projects', 'app') },
+            { kind: 'frontend', path: (0, path_1.join)(cwd, 'packages', 'app') },
+        ];
+        for (const candidate of monorepoCandidates) {
+            if (!filesystem.exists((0, path_1.join)(candidate.path, 'package.json')))
+                continue;
+            if (candidate.kind === 'backend') {
+                try {
+                    const subPkg = JSON.parse(filesystem.read((0, path_1.join)(candidate.path, 'package.json')) || '{}');
+                    const subDeps = Object.assign(Object.assign({}, subPkg.dependencies), subPkg.devDependencies);
+                    if (subDeps['@lenne.tech/nest-server'] || (0, framework_detection_1.isVendoredProject)(candidate.path)) {
+                        projectInfo.monorepoSubprojects.push({
+                            frameworkMode: (0, framework_detection_1.detectFrameworkMode)(candidate.path),
+                            kind: 'backend',
+                            path: candidate.path,
+                        });
+                    }
+                }
+                catch (_d) {
+                    // ignore
+                }
+            }
+            else {
+                try {
+                    const subPkg = JSON.parse(filesystem.read((0, path_1.join)(candidate.path, 'package.json')) || '{}');
+                    const subDeps = Object.assign(Object.assign({}, subPkg.dependencies), subPkg.devDependencies);
+                    if (subDeps['@lenne.tech/nuxt-extensions'] || (0, frontend_framework_detection_1.isVendoredAppProject)(candidate.path)) {
+                        projectInfo.monorepoSubprojects.push({
+                            frameworkMode: (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(candidate.path),
+                            kind: 'frontend',
+                            path: candidate.path,
+                        });
+                    }
+                }
+                catch (_e) {
+                    // ignore
+                }
+            }
+        }
         // Check for git
         try {
             const gitRoot = yield system.run('git rev-parse --show-toplevel 2>/dev/null');
@@ -101,7 +154,7 @@ const StatusCommand = {
                 projectInfo.gitBranch = (branch === null || branch === void 0 ? void 0 : branch.trim()) || null;
             }
         }
-        catch (_d) {
+        catch (_f) {
             // Not a git repository
         }
         // Get Node/npm versions
@@ -109,7 +162,7 @@ const StatusCommand = {
             projectInfo.nodeVersion = ((_a = (yield system.run('node --version 2>/dev/null'))) === null || _a === void 0 ? void 0 : _a.trim()) || null;
             projectInfo.npmVersion = ((_b = (yield system.run('npm --version 2>/dev/null'))) === null || _b === void 0 ? void 0 : _b.trim()) || null;
         }
-        catch (_e) {
+        catch (_g) {
             // Ignore errors
         }
         // Display project info
@@ -132,6 +185,32 @@ const StatusCommand = {
                     : 'npm (@lenne.tech/nest-server dependency)';
                 info(`  Framework: ${modeLabel}`);
             }
+            if (projectInfo.frontendFrameworkMode) {
+                const frontendModeLabel = projectInfo.frontendFrameworkMode === 'vendor'
+                    ? 'vendor (app/core/, VENDOR.md)'
+                    : 'npm (@lenne.tech/nuxt-extensions dependency)';
+                info(`  Frontend Framework: ${frontendModeLabel}`);
+            }
+        }
+        // Show monorepo subprojects if we detected any (typically at monorepo root)
+        if (projectInfo.monorepoSubprojects.length > 0) {
+            info('');
+            info(colors.bold('Monorepo Subprojects:'));
+            for (const sub of projectInfo.monorepoSubprojects) {
+                const relPath = sub.path.replace(`${cwd}/`, '');
+                if (sub.kind === 'backend') {
+                    const label = sub.frameworkMode === 'vendor'
+                        ? 'vendor (src/core/, VENDOR.md)'
+                        : 'npm (@lenne.tech/nest-server dependency)';
+                    info(`  Backend:  ${relPath} → ${label}`);
+                }
+                else {
+                    const label = sub.frameworkMode === 'vendor'
+                        ? 'vendor (app/core/, VENDOR.md)'
+                        : 'npm (@lenne.tech/nuxt-extensions dependency)';
+                    info(`  Frontend: ${relPath} → ${label}`);
+                }
+            }
         }
         if (projectInfo.hasGit) {
             info('');

package/build/config/vendor-frontend-runtime-deps.json

@@ -0,0 +1,4 @@
+{
+  "$comment": "Upstream @lenne.tech/nuxt-extensions devDependencies that must be promoted to regular dependencies in vendor mode. Currently empty because nuxt-extensions has only @nuxt/kit as a direct dependency (which is handled explicitly during vendoring).",
+  "runtimeHelpers": []
+}