@lenne.tech/cli 1.19.0 → 1.21.0

package/build/commands/ports/scan.js

@@ -0,0 +1,131 @@
+"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 fs_1 = require("fs");
+const path_1 = require("path");
+const port_registry_1 = require("../../lib/port-registry");
+/**
+ * Rebuild the port registry from the filesystem.
+ *
+ * Walks the given directory (default: cwd) up to depth 3, looking for
+ * `lt.config.json` + `package.json` pairs or workspace markers. Re-allocates
+ * a slot for each new project found; preserves slots for projects whose
+ * names already exist in the registry.
+ */
+const ScanCommand = {
+    alias: [],
+    description: 'Rebuild port registry',
+    hidden: false,
+    name: 'scan',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        const { filesystem, parameters, print: { colors, info, success }, } = toolbox;
+        const startDir = parameters.first ? filesystem.path(parameters.first) : filesystem.cwd();
+        info('');
+        info(colors.bold(`Scanning for projects under ${startDir} ...`));
+        const found = walkForProjects(startDir, 0, 3);
+        info(colors.dim(`Found ${found.length} candidate project(s)`));
+        const registry = (0, port_registry_1.loadRegistry)();
+        let added = 0;
+        let kept = 0;
+        let dirty = false;
+        for (const project of found) {
+            const slug = (0, port_registry_1.projectSlug)(project.path);
+            const existing = registry.projects[slug];
+            if (existing) {
+                if (existing.path !== project.path) {
+                    existing.path = project.path;
+                    dirty = true;
+                }
+                kept++;
+                continue;
+            }
+            const slot = (0, port_registry_1.allocateSlot)(slug, registry);
+            registry.projects[slug] = { path: project.path, ports: (0, port_registry_1.portsForSlot)(slot), slot };
+            added++;
+            dirty = true;
+        }
+        if (dirty)
+            (0, port_registry_1.saveRegistry)(registry);
+        success(`Registry updated: ${added} new, ${kept} kept (total: ${Object.keys(registry.projects).length})`);
+        if (!parameters.options.fromGluegunMenu) {
+            process.exit();
+        }
+        return `ports scan: ${added} new`;
+    }),
+};
+/** A directory looks like a project if it has `package.json` with a non-empty `name` field. */
+function looksLikeProject(dir) {
+    if (!(0, fs_1.existsSync)((0, path_1.join)(dir, 'package.json')))
+        return false;
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(dir, 'package.json'), 'utf8'));
+        return Boolean(pkg.name);
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Recursive project discovery.
+ *
+ * Stops descending into a directory as soon as a project marker is detected
+ * (lt.config.json with package.json, pnpm-workspace.yaml, or `projects/`).
+ * Skips dotdirs and `node_modules`. Skips symlinks (lstatSync) to avoid
+ * traversal loops on pathological filesystems.
+ */
+function walkForProjects(dir, depth, maxDepth) {
+    if (depth > maxDepth)
+        return [];
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    const out = [];
+    // A project is detected if EITHER an lt.config.json exists OR a workspace marker is found.
+    if ((0, fs_1.existsSync)((0, path_1.join)(dir, 'lt.config.json'))) {
+        if (looksLikeProject(dir)) {
+            out.push({ path: dir });
+            return out; // don't recurse into a detected project
+        }
+    }
+    if ((0, fs_1.existsSync)((0, path_1.join)(dir, 'pnpm-workspace.yaml')) || (0, fs_1.existsSync)((0, path_1.join)(dir, 'projects'))) {
+        out.push({ path: dir });
+        return out;
+    }
+    let entries;
+    try {
+        entries = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+    }
+    catch (_a) {
+        return [];
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') || entry.name === 'node_modules')
+            continue;
+        // Use the cheap Dirent check first — it doesn't need an extra syscall.
+        if (!entry.isDirectory()) {
+            // Could still be a symlink that points to a directory. Skip those to
+            // avoid traversal loops.
+            if (!entry.isSymbolicLink())
+                continue;
+            let s;
+            try {
+                s = (0, fs_1.lstatSync)((0, path_1.join)(dir, entry.name));
+            }
+            catch (_b) {
+                continue;
+            }
+            if (s.isSymbolicLink())
+                continue;
+        }
+        out.push(...walkForProjects((0, path_1.join)(dir, entry.name), depth + 1, maxDepth));
+    }
+    return out;
+}
+module.exports = ScanCommand;

package/build/commands/server/create.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const workspace_integration_1 = require("../../lib/workspace-integration");
 /**
  * Create a new server
  */
@@ -42,6 +43,19 @@ const NewCommand = {
                 { description: 'Git branch to clone from', flag: '--branch', required: false, type: 'string' },
                 { description: 'Copy from local path instead of cloning', flag: '--copy', required: false, type: 'string' },
                 { description: 'Symlink to local path instead of cloning', flag: '--link', required: false, type: 'string' },
+                {
+                    description: 'Backend framework consumption mode',
+                    flag: '--framework-mode',
+                    required: false,
+                    type: 'string',
+                    values: ['npm', 'vendor'],
+                },
+                {
+                    description: 'Upstream nest-server branch/tag to vendor (with --framework-mode vendor)',
+                    flag: '--framework-upstream-branch',
+                    required: false,
+                    type: 'string',
+                },
                 {
                     default: false,
                     description: 'Use experimental nest-base template (Bun + Prisma + Postgres)',
@@ -49,6 +63,20 @@ const NewCommand = {
                     required: false,
                     type: 'boolean',
                 },
+                {
+                    default: false,
+                    description: 'Print resolved plan and exit without making any changes',
+                    flag: '--dry-run',
+                    required: false,
+                    type: 'boolean',
+                },
+                {
+                    default: false,
+                    description: 'Override the workspace-detection abort under --noConfirm',
+                    flag: '--force',
+                    required: false,
+                    type: 'boolean',
+                },
                 {
                     default: false,
                     description: 'Skip all interactive prompts',
@@ -84,7 +112,11 @@ const NewCommand = {
         const cliApiMode = parameters.options['api-mode'] || parameters.options.apiMode;
         const cliFrameworkMode = parameters.options['framework-mode'];
         const cliFrameworkUpstreamBranch = parameters.options['framework-upstream-branch'];
+        const cliDryRun = parameters.options['dry-run'];
+        const cliForce = parameters.options.force;
         const experimental = parameters.options.next === true || parameters.options.next === 'true';
+        const dryRun = cliDryRun === true || cliDryRun === 'true';
+        const force = cliForce === true || cliForce === 'true';
         // Determine noConfirm with priority: CLI > config > global > default (false)
         const noConfirm = config.getNoConfirm({
             cliValue: cliNoConfirm,
@@ -96,16 +128,41 @@ const NewCommand = {
         // Info
         info('Create a new server');
         // Hint for non-interactive callers (e.g. Claude Code)
-        toolbox.tools.nonInteractiveHint('lt server create --name <name> --api-mode <Rest|GraphQL|Both> [--next] --noConfirm');
+        toolbox.tools.nonInteractiveHint('lt server create --name <name> --api-mode <Rest|GraphQL|Both> --framework-mode <npm|vendor> [--next] [--dry-run] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
         }
-        // Get name
-        const name = yield helper.getInput(parameters.first, {
-            name: 'server name',
-            showError: true,
+        // Workspace-awareness: bundled into runStandaloneWorkspaceGate so
+        // server/frontend commands share the print + prompt + decision +
+        // exit logic. Three modes:
+        //   - interactive             → confirm prompt
+        //   - non-interactive         → refuse (KI/CI default — fail loud)
+        //   - non-interactive + force → proceed with a hint
+        const proceed = yield (0, workspace_integration_1.runStandaloneWorkspaceGate)({
+            cwd: '.',
+            filesystem,
+            force,
+            fromGluegunMenu: Boolean(toolbox.parameters.options.fromGluegunMenu),
+            noConfirmFlag: noConfirm,
+            pieceName: 'api',
+            print: { confirm, error, info },
+            projectKind: 'server',
+            suggestion: 'lt fullstack add-api',
         });
+        if (!proceed)
+            return;
+        // Get name. Honour the explicit `--name <slug>` flag (declared as
+        // required in the help-json contract) before falling back to the
+        // first positional argument or interactive input. Without this, a
+        // non-interactive caller passing only `--name my-srv` is forced
+        // into the prompt because `parameters.first` is empty.
+        const cliName = parameters.options.name;
+        const name = cliName ||
+            (yield helper.getInput(parameters.first, {
+                name: 'server name',
+                showError: true,
+            }));
         if (!name) {
             return;
         }
@@ -122,7 +179,10 @@ const NewCommand = {
         const linkPath = cliLink || configLink;
         // Determine branch with priority: CLI > config
         const branch = cliBranch || configBranch;
-        // Determine description with priority: CLI > config > interactive
+        // Determine description with priority: CLI > config > interactive.
+        // Skip the interactive prompt under --noConfirm; description is
+        // optional and defaulting to the project name keeps the package.json
+        // valid for non-interactive callers.
         let description;
         if (cliDescription) {
             description = cliDescription;
@@ -131,13 +191,17 @@ const NewCommand = {
             description = configDescription.replace('{name}', name);
             info(`Using description from lt.config: ${description}`);
         }
+        else if (noConfirm) {
+            description = '';
+        }
         else {
             description = yield helper.getInput(parameters.second, {
                 name: 'Description',
                 showError: false,
             });
         }
-        // Determine author with priority: CLI > config > global > interactive
+        // Determine author with priority: CLI > config > global > interactive.
+        // Skip the prompt under --noConfirm.
         let author;
         if (cliAuthor) {
             author = cliAuthor;
@@ -150,6 +214,9 @@ const NewCommand = {
             author = globalAuthor;
             info(`Using author from lt.config defaults: ${author}`);
         }
+        else if (noConfirm) {
+            author = '';
+        }
         else {
             author = yield helper.getInput('', {
                 name: 'Author',
@@ -229,6 +296,50 @@ const NewCommand = {
         const frameworkUpstreamBranch = typeof cliFrameworkUpstreamBranch === 'string' && cliFrameworkUpstreamBranch.length > 0
             ? cliFrameworkUpstreamBranch
             : undefined;
+        // Dry-run: print the resolved plan and exit without any disk
+        // changes. Mirrors the dry-run surface of `lt fullstack init` /
+        // `add-api` / `add-app` so agent workflows can preview the
+        // standalone path the same way.
+        if (dryRun) {
+            info('');
+            info('Dry-run plan:');
+            info(`  name:                       ${name}`);
+            info(`  projectDir:                 ${projectDir}`);
+            info(`  apiMode:                    ${apiMode}`);
+            info(`  frameworkMode:              ${frameworkMode}`);
+            if (frameworkUpstreamBranch) {
+                info(`  frameworkUpstreamBranch:    ${frameworkUpstreamBranch}`);
+            }
+            info(`  branch:                     ${branch || '(default)'}`);
+            info(`  copy:                       ${copyPath || '(none)'}`);
+            info(`  link:                       ${linkPath || '(none)'}`);
+            info(`  experimental (--next):      ${experimental}`);
+            info(`  description:                ${description || '(none)'}`);
+            info(`  author:                     ${author || '(none)'}`);
+            info('');
+            info('Would execute:');
+            if (experimental) {
+                info(`  1. clone nest-base → ./${projectDir}`);
+                info(`  2. patch package.json (name = ${projectDir})`);
+            }
+            else if (frameworkMode === 'vendor') {
+                info(`  1. clone nest-server-starter → ./${projectDir}`);
+                info(`  2. clone @lenne.tech/nest-server${frameworkUpstreamBranch ? ` (${frameworkUpstreamBranch})` : ''} → /tmp`);
+                info(`  3. vendor core/ + flatten-fix + codemod consumer imports`);
+                info(`  4. merge upstream deps`);
+                info(`  5. run processApiMode(${apiMode})`);
+            }
+            else {
+                info(`  1. clone nest-server-starter → ./${projectDir}`);
+                info(`  2. run processApiMode(${apiMode})`);
+            }
+            info(`  N. write ./${projectDir}/lt.config.json`);
+            info('');
+            if (!toolbox.parameters.options.fromGluegunMenu) {
+                process.exit();
+            }
+            return `dry-run server create (${frameworkMode} / ${apiMode})`;
+        }
         // Setup server using Server extension
         const setupSpinner = spin(`Setting up server${linkPath ? ' (link)' : copyPath ? ' (copy)' : branch ? ` (branch: ${branch})` : ''}`);
         const result = yield server.setupServer(`./${projectDir}`, {

package/build/commands/status.js

@@ -12,6 +12,8 @@ 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");
+const port_registry_1 = require("../lib/port-registry");
+const workspace_integration_1 = require("../lib/workspace-integration");
 /**
  * Show project status and context
  */
@@ -21,7 +23,7 @@ const StatusCommand = {
     hidden: false,
     name: 'status',
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
+        var _a, _b, _c;
         const { filesystem, print: { colors, info, success, warning }, system, } = toolbox;
         const cwd = filesystem.cwd();
         info('');
@@ -42,6 +44,18 @@ const StatusCommand = {
             packageName: null,
             packageVersion: null,
             projectType: 'unknown',
+            // Probe layout at the workspace root if cwd is inside a
+            // sub-project; otherwise probe at cwd. Without this, status
+            // shown from `projects/api/src/` would report both halves
+            // missing because there's no `projects/` underneath cwd.
+            workspaceLayout: (() => {
+                const ctx = (0, workspace_integration_1.detectSubProjectContext)(cwd, filesystem);
+                return (0, workspace_integration_1.detectWorkspaceLayout)(ctx ? ctx.workspaceRoot : cwd, filesystem);
+            })(),
+            workspaceSubProject: (() => {
+                const ctx = (0, workspace_integration_1.detectSubProjectContext)(cwd, filesystem);
+                return ctx ? { kind: ctx.kind, root: ctx.workspaceRoot } : null;
+            })(),
         };
         // Check for lt.config
         const ltConfigFiles = ['lt.config.json', 'lt.config.yaml', 'lt.config'];
@@ -94,7 +108,7 @@ const StatusCommand = {
                     projectInfo.projectType = 'node';
                 }
             }
-            catch (_c) {
+            catch (_d) {
                 // Ignore parse errors
             }
         }
@@ -123,7 +137,7 @@ const StatusCommand = {
                         });
                     }
                 }
-                catch (_d) {
+                catch (_e) {
                     // ignore
                 }
             }
@@ -139,7 +153,7 @@ const StatusCommand = {
                         });
                     }
                 }
-                catch (_e) {
+                catch (_f) {
                     // ignore
                 }
             }
@@ -154,7 +168,7 @@ const StatusCommand = {
                 projectInfo.gitBranch = (branch === null || branch === void 0 ? void 0 : branch.trim()) || null;
             }
         }
-        catch (_f) {
+        catch (_g) {
             // Not a git repository
         }
         // Get Node/npm versions
@@ -162,7 +176,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 (_g) {
+        catch (_h) {
             // Ignore errors
         }
         // Display project info
@@ -192,6 +206,65 @@ const StatusCommand = {
                 info(`  Frontend Framework: ${frontendModeLabel}`);
             }
         }
+        // Workspace overview — surfaces the layout that drives the
+        // `add-api` / `add-app` / standalone gate decisions. Shown
+        // whenever we're inside a workspace OR a sub-project of one,
+        // so users immediately see what's missing and where the
+        // workspace root is.
+        if (projectInfo.workspaceLayout.hasWorkspace || projectInfo.workspaceSubProject) {
+            info('');
+            info(colors.bold('Workspace:'));
+            if (projectInfo.workspaceSubProject) {
+                const { kind, root } = projectInfo.workspaceSubProject;
+                warning(`  You are inside projects/${kind}/ of a workspace.`);
+                info(`  Root:     ${root}`);
+                info(colors.dim(`  Hint: cd to the workspace root for \`lt fullstack add-${kind === 'api' ? 'app' : 'api'}\``));
+            }
+            else {
+                success('  Detected (pnpm-workspace.yaml, package.json#workspaces, or projects/)');
+            }
+            const apiMark = projectInfo.workspaceLayout.hasApi ? colors.green('✓') : colors.yellow('✗');
+            const appMark = projectInfo.workspaceLayout.hasApp ? colors.green('✓') : colors.yellow('✗');
+            info(`  ${apiMark} projects/api/`);
+            info(`  ${appMark} projects/app/`);
+            // Suggest the next step when only one half is present.
+            if (projectInfo.workspaceLayout.hasApp && !projectInfo.workspaceLayout.hasApi) {
+                info(colors.dim('  Hint: `lt fullstack add-api` to integrate a NestJS server.'));
+            }
+            else if (projectInfo.workspaceLayout.hasApi && !projectInfo.workspaceLayout.hasApp) {
+                info(colors.dim('  Hint: `lt fullstack add-app` to integrate a Nuxt or Angular app.'));
+            }
+        }
+        // Local dev orchestration registry — surface slot/ports if registered.
+        // Helps users discover that `lt local` is set up for this project, and
+        // gives a quick inline answer to "what ports does this project use?".
+        {
+            const registryRoot = ((_c = projectInfo.workspaceSubProject) === null || _c === void 0 ? void 0 : _c.root) ||
+                (projectInfo.workspaceLayout.hasWorkspace ? projectInfo.workspaceLayout.workspaceDir : cwd);
+            if (registryRoot) {
+                const slug = (0, port_registry_1.projectSlug)(registryRoot);
+                const entry = (0, port_registry_1.loadRegistry)().projects[slug];
+                if (entry) {
+                    info('');
+                    info(colors.bold('Local dev orchestration (lt local):'));
+                    const ports = (0, port_registry_1.portsForSlot)(entry.slot);
+                    info(`  Slot:     ${entry.slot}`);
+                    info(`  API:      http://localhost:${ports.api}`);
+                    info(`  App:      http://localhost:${ports.app}`);
+                    if (entry.dbName)
+                        info(`  DB:       mongodb://127.0.0.1/${entry.dbName}`);
+                    const state = (0, port_registry_1.loadLocalState)(registryRoot);
+                    const apiAlive = (state === null || state === void 0 ? void 0 : state.pids.api) ? (0, port_registry_1.isPidAlive)(state.pids.api) : false;
+                    const appAlive = (state === null || state === void 0 ? void 0 : state.pids.app) ? (0, port_registry_1.isPidAlive)(state.pids.app) : false;
+                    if (apiAlive || appAlive) {
+                        info(`  Running:  api ${apiAlive ? colors.green('●') : colors.dim('○')}  app ${appAlive ? colors.green('●') : colors.dim('○')}`);
+                    }
+                    else {
+                        info(colors.dim('  Hint: `lt local up` to start API + App with these ports.'));
+                    }
+                }
+            }
+        }
         // Show monorepo subprojects if we detected any (typically at monorepo root)
         if (projectInfo.monorepoSubprojects.length > 0) {
             info('');

package/build/commands/tools/ocr.js

@@ -30,8 +30,13 @@ const NewCommand = {
     description: 'OCR PDFs to Markdown via marker-pdf (MPS-accelerated on Apple Silicon)',
     hidden: false,
     name: 'ocr',
-    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+    // GluegunCommand types `run` against the base `Toolbox`, but the lt CLI
+    // augments it with `helper`, `git`, etc. Cast inside so the implementation
+    // remains typed against the project-specific `ExtendedGluegunToolbox` while
+    // satisfying the upstream `(toolbox: Toolbox) => void` signature.
+    run: (rawToolbox) => __awaiter(void 0, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e;
+        const toolbox = rawToolbox;
         const { parameters, print: { error, info, spin, warning }, } = toolbox;
         const showStatus = !!parameters.options.status;
         const installOnly = !!parameters.options.install;

package/build/extensions/server.js

@@ -1975,21 +1975,31 @@ class Server {
                     literal.setLiteralValue(secretMap.get(text));
                     continue;
                 }
-                // Replace database names (nest-server-ci -> projectDir-ci)
+                // Replace database names so the project gets project-specific DB
+                // names. Matches BOTH the legacy `nest-server-{env}` form AND the
+                // current `nest-server-starter-{env}` form used by the public
+                // nest-server-starter repo. Examples:
+                //   nest-server-starter-local       → ${projectDir}-local
+                //   nest-server-starter-production  → ${projectDir}-production
+                //   nest-server-ci                  → ${projectDir}-ci  (legacy)
+                // The optional `(?:starter-)?` non-capturing group is what fixes
+                // the previously-broken case where dbName: 'nest-server-starter-local'
+                // turned into 'svl-sports-system-starter-local' (-starter- stayed).
                 if (text.includes('nest-server-')) {
-                    literal.setLiteralValue(text.replace(/nest-server-/g, `${projectDir}-`));
+                    literal.setLiteralValue(text.replace(/nest-server-(?:starter-)?/g, `${projectDir}-`));
                 }
             }
             sourceFile.saveSync();
         }
         catch (_a) {
-            // Fallback to regex-based approach if ts-morph fails
+            // Fallback to regex-based approach if ts-morph fails. Same matcher
+            // as the AST branch — keep them in sync.
             let content = this.filesystem.read(configPath);
             if (!content) {
                 return;
             }
             content = this.replaceSecretOrPrivateKeys(content);
-            content = content.replace(/nest-server-(\w+)/g, `${projectDir}-$1`);
+            content = content.replace(/nest-server-(?:starter-)?(\w+)/g, `${projectDir}-$1`);
             this.filesystem.write(configPath, content);
         }
     }