@lenne.tech/cli 1.9.6 → 1.11.0

package/build/commands/fullstack/update.js

@@ -0,0 +1,177 @@
+"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");
+const frontend_framework_detection_1 = require("../../lib/frontend-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.');
+        }
+        // ── Frontend mode-aware instructions ──────────────────────────────
+        info('');
+        info(colors.dim('─'.repeat(60)));
+        info('');
+        // 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/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/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/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;