@lenne.tech/cli 1.12.0 → 1.14.0

package/README.md

@@ -94,6 +94,37 @@ $ lt fullstack init --name myapp --framework-mode vendor --dry-run --noConfirm
 $ lt server create --name myapp --framework-mode vendor
 ```
 
+### Experimental: `--next` (nest-base)
+
+Both `lt fullstack init` and `lt server create` support an experimental
+`--next` flag that swaps the API template from
+[`nest-server-starter`](https://github.com/lenneTech/nest-server-starter)
+(MongoDB) to [`nest-base`](https://github.com/lenneTech/nest-base) — a new
+NestJS stack on **Bun + Prisma 7 + Postgres + Better-Auth** with a built-in
+`/dev` cockpit.
+
+```bash
+# experimental standalone api
+$ lt server create my-next-api --next --noConfirm
+
+# experimental fullstack (nuxt + nest-base)
+$ lt fullstack init --name my-next-app --frontend nuxt --next --noConfirm
+```
+
+When `--next` is set the CLI:
+
+- clones `nest-base` instead of `nest-server-starter`,
+- forces `--api-mode Rest` and `--framework-mode npm` (other modes are not
+  applicable to nest-base),
+- skips `nest-server-starter`-specific patching (`config.env.ts`,
+  `main.ts` Swagger setup, `meta.json`, `lt.config.json`),
+- skips the workspace install in fullstack mode — run `pnpm install` for
+  the frontend and `bun install` for the API yourself.
+
+This option is **experimental** and may change. The downstream `lt server
+module/object/addProp/test/permissions` commands target the classic
+`nest-server` layout and are not yet compatible with `nest-base`.
+
 ### Working on an existing project
 
 All `lt server …` commands (module, object, addProp, test, permissions)

package/build/commands/config/validate.js

@@ -114,6 +114,22 @@ const KNOWN_KEYS = {
                 path: 'string',
             },
         },
+        tools: {
+            crawl: {
+                concurrency: 'number',
+                depth: 'number|all',
+                includeImages: 'boolean',
+                includeSitemap: 'boolean',
+                maxPages: 'number',
+                noConfirm: 'boolean',
+                out: 'string',
+                prune: 'boolean',
+                renderJs: 'boolean',
+                selector: 'string',
+                timeout: 'number',
+            },
+            noConfirm: 'boolean',
+        },
         typescript: {
             create: { author: 'string', noConfirm: 'boolean', updatePackages: 'boolean' },
         },
@@ -165,8 +181,26 @@ function validateConfig(config, knownKeys, path = '') {
         }
         // Validate type
         if (typeof expectedType === 'string') {
-            // Simple type check
-            if (expectedType === 'string' && typeof value !== 'string') {
+            // Simple type check. `'a|b'` means union (e.g. "number|all").
+            if (expectedType.includes('|')) {
+                const tokens = expectedType.split('|').map((t) => t.trim());
+                const ok = tokens.some((token) => {
+                    if (token === 'string')
+                        return typeof value === 'string';
+                    if (token === 'number')
+                        return typeof value === 'number';
+                    if (token === 'boolean')
+                        return typeof value === 'boolean';
+                    if (token === 'array')
+                        return Array.isArray(value);
+                    // Everything else is treated as a string literal enum member.
+                    return value === token;
+                });
+                if (!ok) {
+                    result.errors.push(`${currentPath}: expected ${tokens.join(' | ')}, got ${typeof value}`);
+                }
+            }
+            else if (expectedType === 'string' && typeof value !== 'string') {
                 result.errors.push(`${currentPath}: expected string, got ${typeof value}`);
             }
             else if (expectedType === 'boolean' && typeof value !== 'boolean') {

package/build/commands/fullstack/init.js

@@ -27,7 +27,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> --framework-mode <npm|vendor> [--framework-upstream-branch <ref>] [--dry-run] --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>] [--next] [--dry-run] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
@@ -46,8 +46,9 @@ 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-framework-mode': cliFrontendFrameworkMode, '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, next: cliNext, } = parameters.options;
         const dryRun = cliDryRun === true || cliDryRun === 'true';
+        const experimental = cliNext === true || cliNext === 'true';
         const frameworkUpstreamBranch = typeof cliFrameworkUpstreamBranch === 'string' && cliFrameworkUpstreamBranch.length > 0
             ? cliFrameworkUpstreamBranch
             : undefined;
@@ -109,7 +110,11 @@ const NewCommand = {
         // Determine API mode with priority: CLI > config > global > interactive (default: Rest)
         const globalApiMode = config.getGlobalDefault(ltConfig, 'apiMode');
         let apiMode;
-        if (cliApiMode) {
+        if (experimental) {
+            apiMode = 'Rest';
+            info('Using experimental nest-base template (Bun + Prisma + Postgres + Better-Auth)');
+        }
+        else if (cliApiMode) {
             apiMode = cliApiMode;
         }
         else if (configApiMode) {
@@ -154,7 +159,10 @@ const NewCommand = {
         //
         // Default is still 'npm' until the vendoring pilot is fully evaluated.
         let frameworkMode;
-        if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
+        if (experimental) {
+            frameworkMode = 'npm';
+        }
+        else if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
             frameworkMode = cliFrameworkMode;
         }
         else if (cliFrameworkMode) {
@@ -291,7 +299,10 @@ const NewCommand = {
             info('Would execute:');
             info(`  1. git clone lt-monorepo → ${projectDir}/`);
             info(`  2. setup frontend (${frontend}) → ${projectDir}/projects/app`);
-            if (frameworkMode === 'vendor') {
+            if (experimental) {
+                info(`  3. clone nest-base (experimental) → ${projectDir}/projects/api`);
+            }
+            else 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`);
@@ -420,6 +431,7 @@ const NewCommand = {
                 apiMode,
                 branch: apiBranch,
                 copyPath: apiCopy,
+                experimental,
                 frameworkMode,
                 frameworkUpstreamBranch,
                 linkPath: apiLink,
@@ -466,15 +478,20 @@ const NewCommand = {
             // instead.` and silently disables CVE overrides.
             (0, hoist_workspace_pnpm_config_1.hoistWorkspacePnpmConfig)({ filesystem, projectDir, subProjects: ['projects/api', 'projects/app'] });
             // Install all packages
-            const installSpinner = spin('Install all packages');
-            try {
-                const detectedPm = toolbox.pm.detect(projectDir);
-                yield system.run(`cd ${projectDir} && ${toolbox.pm.install(detectedPm)} && ${toolbox.pm.run('init', detectedPm)}`);
-                installSpinner.succeed('Successfully installed all packages');
+            if (!experimental) {
+                const installSpinner = spin('Install all packages');
+                try {
+                    const detectedPm = toolbox.pm.detect(projectDir);
+                    yield system.run(`cd ${projectDir} && ${toolbox.pm.install(detectedPm)} && ${toolbox.pm.run('init', detectedPm)}`);
+                    installSpinner.succeed('Successfully installed all packages');
+                }
+                catch (err) {
+                    installSpinner.fail(`Failed to install packages: ${err.message}`);
+                    return;
+                }
             }
-            catch (err) {
-                installSpinner.fail(`Failed to install packages: ${err.message}`);
-                return;
+            else {
+                info('Skipping workspace install — run `bun install` (api) and `pnpm install` (app) manually.');
             }
             // Post-install format pass. processApiMode (run earlier in
             // setupServerForFullstack) and convertAppCloneToVendored rewrite
@@ -482,10 +499,10 @@ const NewCommand = {
             // `pnpm run format:check` (multi-line arrays/imports after region
             // stripping, import-path rewrites that now fit single-line). The
             // formatter is only available after install, so we normalize here.
-            if (apiMode && filesystem.isDirectory(`${projectDir}/projects/api`)) {
+            if (!experimental && apiMode && filesystem.isDirectory(`${projectDir}/projects/api`)) {
                 yield toolbox.apiMode.formatProject(`${projectDir}/projects/api`);
             }
-            if (isNuxt && filesystem.isDirectory(`${projectDir}/projects/app`)) {
+            if (!experimental && isNuxt && filesystem.isDirectory(`${projectDir}/projects/app`)) {
                 yield toolbox.apiMode.formatProject(`${projectDir}/projects/app`);
             }
             // Create initial commit after everything is set up
@@ -511,9 +528,18 @@ const NewCommand = {
             success(`Generated fullstack workspace with ${frontend} in ${projectDir} with ${name} app in ${helper.msToMinutesAndSeconds(timer())}m.`);
             info('');
             info('Next:');
-            info(`  Run ${name}`);
-            info(`  $ cd ${projectDir}`);
-            info(`  $ ${toolbox.pm.run('start')}`);
+            if (experimental) {
+                info(`  $ cd ${projectDir}`);
+                info('  Frontend: cd projects/app && pnpm install');
+                info('  API:      cd projects/api && bun install');
+                info('  Configure projects/api/.env (see .env.example)');
+                info('  Start Postgres + run prisma generate / migrate');
+            }
+            else {
+                info(`  Run ${name}`);
+                info(`  $ cd ${projectDir}`);
+                info(`  $ ${toolbox.pm.run('start')}`);
+            }
             info('');
             if (!toolbox.parameters.options.fromGluegunMenu) {
                 process.exit();

package/build/commands/server/create.js

@@ -42,6 +42,13 @@ 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' },
+                {
+                    default: false,
+                    description: 'Use experimental nest-base template (Bun + Prisma + Postgres)',
+                    flag: '--next',
+                    required: false,
+                    type: 'boolean',
+                },
                 {
                     default: false,
                     description: 'Skip all interactive prompts',
@@ -77,6 +84,7 @@ 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 experimental = parameters.options.next === true || parameters.options.next === 'true';
         // Determine noConfirm with priority: CLI > config > global > default (false)
         const noConfirm = config.getNoConfirm({
             cliValue: cliNoConfirm,
@@ -88,7 +96,7 @@ 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> --noConfirm');
+        toolbox.tools.nonInteractiveHint('lt server create --name <name> --api-mode <Rest|GraphQL|Both> [--next] --noConfirm');
         // Check git
         if (!(yield git.gitInstalled())) {
             return;
@@ -150,7 +158,11 @@ const NewCommand = {
         }
         // Determine API mode with priority: CLI > config > global > interactive (default: Rest)
         let apiMode;
-        if (cliApiMode) {
+        if (experimental) {
+            apiMode = 'Rest';
+            info('Using experimental nest-base template (Bun + Prisma + Postgres + Better-Auth)');
+        }
+        else if (cliApiMode) {
             apiMode = cliApiMode;
         }
         else if (configApiMode) {
@@ -184,7 +196,10 @@ const NewCommand = {
         // 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') {
+        if (experimental) {
+            frameworkMode = 'npm';
+        }
+        else if (cliFrameworkMode === 'npm' || cliFrameworkMode === 'vendor') {
             frameworkMode = cliFrameworkMode;
         }
         else if (cliFrameworkMode) {
@@ -222,6 +237,7 @@ const NewCommand = {
             branch,
             copyPath,
             description,
+            experimental,
             frameworkMode,
             frameworkUpstreamBranch,
             linkPath,
@@ -279,36 +295,47 @@ const NewCommand = {
         }
         // Derive controller type from API mode and save project config
         const controllerType = apiMode;
-        // Create lt.config.json
-        const projectConfig = {
-            commands: {
-                server: {
-                    module: {
-                        controller: controllerType,
+        if (!experimental) {
+            // Create lt.config.json
+            const projectConfig = {
+                commands: {
+                    server: {
+                        module: {
+                            controller: controllerType,
+                        },
                     },
                 },
-            },
-            meta: {
-                apiMode,
-                version: '1.0.0',
-            },
-        };
-        const configPath = filesystem.path(projectDir, 'lt.config.json');
-        filesystem.write(configPath, projectConfig, { jsonIndent: 2 });
-        info('');
-        success(`Configuration saved to ${projectDir}/lt.config.json`);
-        info(`   API mode: ${apiMode}`);
-        info(`   Default controller type: ${controllerType}`);
+                meta: {
+                    apiMode,
+                    version: '1.0.0',
+                },
+            };
+            const configPath = filesystem.path(projectDir, 'lt.config.json');
+            filesystem.write(configPath, projectConfig, { jsonIndent: 2 });
+            info('');
+            success(`Configuration saved to ${projectDir}/lt.config.json`);
+            info(`   API mode: ${apiMode}`);
+            info(`   Default controller type: ${controllerType}`);
+        }
         // We're done, so show what to do next
         info('');
         success(`Generated ${name} server with lenne.Tech CLI ${meta.version()} in ${helper.msToMinutesAndSeconds(timer())}m.`);
         info('');
         info('Next:');
-        info('  Start database server (e.g. MongoDB)');
-        info(`  Check config: ${projectDir}/src/config.env.ts`);
-        info(`  Go to project directory: cd ${projectDir}`);
-        info(`  Run tests: ${toolbox.pm.run('test:e2e')}`);
-        info(`  Start server: ${toolbox.pm.run('start')}`);
+        if (experimental) {
+            info(`  Go to project directory: cd ${projectDir}`);
+            info('  Install dependencies: bun install');
+            info('  Configure .env (see .env.example)');
+            info('  Start Postgres + run prisma generate / migrate');
+            info('  Start server: bun run dev');
+        }
+        else {
+            info('  Start database server (e.g. MongoDB)');
+            info(`  Check config: ${projectDir}/src/config.env.ts`);
+            info(`  Go to project directory: cd ${projectDir}`);
+            info(`  Run tests: ${toolbox.pm.run('test:e2e')}`);
+            info(`  Start server: ${toolbox.pm.run('start')}`);
+        }
         info('');
         if (!toolbox.parameters.options.fromGluegunMenu) {
             process.exit();

package/build/commands/tools/crawl.js

@@ -0,0 +1,307 @@
+"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 crawler_1 = require("../../lib/crawler");
+/**
+ * Crawl a website (optionally following same-origin links up to a
+ * configurable depth) and store the content as Markdown files for use
+ * as a Claude Code knowledge base. Inspired by ../../../../chrome-md:
+ * shares the defuddle + Turndown extraction pipeline but runs headless
+ * from Node and follows links / sitemaps automatically.
+ */
+const NewCommand = {
+    alias: ['cr'],
+    description: 'Crawl site to Markdown',
+    hidden: false,
+    name: 'crawl',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const { config, filesystem, helper, parameters, print: { error, info, spin, success, warning }, prompt: { confirm }, tools, } = toolbox;
+        if (tools.helpJson({
+            aliases: ['cr'],
+            description: 'Crawl a website into Markdown files (for Claude Code knowledge bases)',
+            name: 'crawl',
+            options: [
+                {
+                    description: 'Start URL (absolute http/https URL)',
+                    flag: '--url',
+                    required: true,
+                    type: 'string',
+                },
+                {
+                    default: '.',
+                    description: 'Output directory (created if missing)',
+                    flag: '--out',
+                    type: 'string',
+                },
+                {
+                    default: 0,
+                    description: 'Link depth. 0 = only start page; 1 = + direct links; N = up to N hops; "all" (or -1) = follow every same-origin link until --max-pages is reached',
+                    flag: '--depth',
+                    type: 'number|all',
+                },
+                {
+                    default: true,
+                    description: 'Download images and inline them with local paths',
+                    flag: '--images',
+                    type: 'boolean',
+                },
+                {
+                    default: true,
+                    description: 'Also seed queue from <origin>/sitemap.xml',
+                    flag: '--sitemap',
+                    type: 'boolean',
+                },
+                {
+                    default: 4,
+                    description: 'Parallel HTTP requests',
+                    flag: '--concurrency',
+                    type: 'number',
+                },
+                {
+                    default: 200,
+                    description: 'Maximum number of pages to crawl (safety cap)',
+                    flag: '--max-pages',
+                    type: 'number',
+                },
+                {
+                    description: 'CSS selector for the main content container',
+                    flag: '--selector',
+                    type: 'string',
+                },
+                {
+                    default: 20000,
+                    description: 'HTTP request timeout in ms',
+                    flag: '--timeout',
+                    type: 'number',
+                },
+                {
+                    default: false,
+                    description: 'Shortcut for --depth all (follows every same-origin link until --max-pages)',
+                    flag: '--all',
+                    type: 'boolean',
+                },
+                {
+                    default: true,
+                    description: "Render pages through a headless browser before extracting (for SPAs like Vue/Nuxt/React/Angular). Uses playwright-core with system Chrome / Edge, falling back to Playwright's bundled chromium. Disable with --no-render for plain HTTP fetches.",
+                    flag: '--render',
+                    type: 'boolean',
+                },
+                {
+                    default: false,
+                    description: 'If --render cannot find any browser, auto-install Playwright chromium (one-time ~170 MB download).',
+                    flag: '--install-browser',
+                    type: 'boolean',
+                },
+                {
+                    default: true,
+                    description: 'After a multi-page crawl, remove any .md or image files inside <outDir>/pages and <outDir>/images that were not written by this run. Disable with --no-prune to preserve old files.',
+                    flag: '--prune',
+                    type: 'boolean',
+                },
+                {
+                    default: false,
+                    description: 'Skip confirmation prompts',
+                    flag: '--noConfirm',
+                    type: 'boolean',
+                },
+            ],
+        })) {
+            return 'crawl';
+        }
+        tools.nonInteractiveHint('lt tools crawl <url> --out <dir> --depth 1 --noConfirm');
+        const ltConfig = config.loadConfig();
+        const commandConfig = (_b = (_a = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _a === void 0 ? void 0 : _a.tools) === null || _b === void 0 ? void 0 : _b.crawl;
+        // URL: positional argument > --url > interactive prompt.
+        const urlInput = parameters.first ||
+            parameters.options.url ||
+            (yield helper.getInput(undefined, { name: 'Website URL', showError: false }));
+        if (!urlInput) {
+            error('No URL provided');
+            return;
+        }
+        const url = normalizeSeedUrl(urlInput);
+        try {
+            new URL(url);
+        }
+        catch (_f) {
+            error(`Invalid URL: ${urlInput}`);
+            return;
+        }
+        const depthRaw = config.getValue({
+            // `--all` is a convenience shortcut for `--depth all`. It wins
+            // over a numeric `--depth` so users can combine both.
+            cliValue: parameters.options.all === true ? 'all' : parameters.options.depth,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.depth,
+            defaultValue: 0,
+        });
+        const depth = parseDepth(depthRaw);
+        const includeImages = config.getValue({
+            cliValue: parameters.options.images === false ? false : undefined,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.includeImages,
+            defaultValue: true,
+        });
+        const includeSitemap = config.getValue({
+            cliValue: parameters.options.sitemap === false ? false : undefined,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.includeSitemap,
+            defaultValue: true,
+        });
+        const concurrency = Number(config.getValue({
+            cliValue: parameters.options.concurrency,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.concurrency,
+            defaultValue: 4,
+        }));
+        const maxPages = Number(config.getValue({
+            cliValue: (_c = parameters.options.maxPages) !== null && _c !== void 0 ? _c : parameters.options['max-pages'],
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.maxPages,
+            defaultValue: 200,
+        }));
+        const timeout = Number(config.getValue({
+            cliValue: parameters.options.timeout,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.timeout,
+            defaultValue: 20000,
+        }));
+        const selector = config.getValue({
+            cliValue: parameters.options.selector,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.selector,
+        });
+        // `--render` and `--prune` default ON — the common case is a
+        // full SPA-aware knowledge-base crawl that stays in sync on
+        // updates. `--no-render` / `--no-prune` opt out explicitly.
+        const renderJs = config.getValue({
+            cliValue: parameters.options.render === false ? false : undefined,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.renderJs,
+            defaultValue: true,
+        });
+        const installBrowser = parameters.options['install-browser'] === true || parameters.options.installBrowser === true;
+        const pruneOrphans = config.getValue({
+            cliValue: parameters.options.prune === false ? false : undefined,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.prune,
+            defaultValue: true,
+        });
+        const outDir = (0, path_1.resolve)(config.getValue({
+            cliValue: (_d = parameters.options.out) !== null && _d !== void 0 ? _d : parameters.options.output,
+            configValue: commandConfig === null || commandConfig === void 0 ? void 0 : commandConfig.out,
+            defaultValue: filesystem.cwd(),
+        }) || filesystem.cwd());
+        const noConfirm = config.getNoConfirm({
+            cliValue: parameters.options.noConfirm,
+            commandConfig,
+            config: ltConfig,
+            parentConfig: (_e = ltConfig === null || ltConfig === void 0 ? void 0 : ltConfig.commands) === null || _e === void 0 ? void 0 : _e.tools,
+        });
+        info('');
+        info(`Crawling: ${url}`);
+        info(`Output:   ${outDir}`);
+        info(`Depth:    ${depth === 'all' ? 'all (bounded by --max-pages)' : depth}`);
+        info(`Sitemap:  ${includeSitemap ? 'yes' : 'no'}`);
+        info(`Images:   ${includeImages ? 'yes' : 'no'}`);
+        info(`Parallel: ${concurrency}`);
+        info(`Max:      ${maxPages} pages`);
+        info(`Render:   ${renderJs ? 'yes (headless browser)' : 'no (raw HTTP)'}`);
+        info(`Prune:    ${pruneOrphans ? 'yes (remove orphaned pages/images)' : 'no'}`);
+        if (selector)
+            info(`Selector: ${selector}`);
+        info('');
+        if (!noConfirm && !(yield confirm('Start crawl?'))) {
+            return 'crawl cancelled';
+        }
+        const spinner = spin('Crawling...');
+        const result = yield (0, crawler_1.crawlSite)({
+            autoInstallBrowser: installBrowser,
+            concurrency,
+            depth,
+            includeImages,
+            includeSitemap,
+            maxPages,
+            onLog: (msg) => {
+                spinner.text = msg;
+            },
+            outDir,
+            prune: pruneOrphans,
+            renderJs,
+            selector,
+            timeout,
+            url,
+        }).catch((err) => {
+            spinner.fail('Crawl failed');
+            error(err.message);
+            return null;
+        });
+        if (!result) {
+            return;
+        }
+        spinner.succeed(`Crawl complete: ${result.pages.length} page(s)`);
+        info('');
+        if (result.indexFile) {
+            success(`Overview: ${result.indexFile}`);
+        }
+        for (const page of result.pages.slice(0, 10)) {
+            info(`  - ${page.relativePath}  (${page.url})`);
+        }
+        if (result.pages.length > 10) {
+            info(`  ... and ${result.pages.length - 10} more`);
+        }
+        if (result.pruned.length > 0) {
+            info(`Pruned ${result.pruned.length} orphaned file(s)`);
+            for (const path of result.pruned.slice(0, 5)) {
+                info(`  - ${path}`);
+            }
+            if (result.pruned.length > 5)
+                info(`  ... and ${result.pruned.length - 5} more`);
+        }
+        if (result.skipped.length > 0) {
+            warning(`Skipped ${result.skipped.length} URL(s) (non-HTML or foreign origin)`);
+        }
+        if (result.errors.length > 0) {
+            warning(`${result.errors.length} error(s):`);
+            for (const err of result.errors.slice(0, 5)) {
+                warning(`  - ${err.url}: ${err.reason}`);
+            }
+        }
+        if (!toolbox.parameters.options.fromGluegunMenu) {
+            process.exit();
+        }
+        return `crawled ${result.pages.length} pages`;
+    }),
+};
+function normalizeSeedUrl(raw) {
+    const trimmed = raw.trim();
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    return `https://${trimmed}`;
+}
+/**
+ * Parse the --depth parameter. Accepts positive integers, the string
+ * "all", and negative values (treated as "all"). Invalid values fall
+ * back to `0` so the crawl still runs against the seed URL.
+ */
+function parseDepth(raw) {
+    if (raw === undefined || raw === null)
+        return 0;
+    if (typeof raw === 'string') {
+        const normalized = raw.trim().toLowerCase();
+        if (normalized === 'all' || normalized === '-1')
+            return 'all';
+        const n = Number(normalized);
+        if (!Number.isFinite(n))
+            return 0;
+        return n < 0 ? 'all' : Math.floor(n);
+    }
+    if (typeof raw === 'number') {
+        if (!Number.isFinite(raw))
+            return 'all';
+        return raw < 0 ? 'all' : Math.floor(raw);
+    }
+    return 0;
+}
+exports.default = NewCommand;