@lenne.tech/cli 1.27.0 → 1.29.0

package/build/cli.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const gluegun_1 = require("gluegun");
 const path_1 = require("path");
+const command_help_1 = require("./lib/command-help");
 /**
  * Create the cli and kick it off
  */
@@ -26,9 +27,14 @@ function run(argv) {
                 commandFilePattern: ['*.js'],
                 extensionFilePattern: ['*.js'],
             })
-                .help() // provides default for help, h, --help, -h
+                .help() // provides default for top-level help, h, --help, -h
                 .version() // provides default for version, v, --version, -v
                 .create();
+            // Generic per-command `--help` / `-h`: gluegun's `.help()` only covers the
+            // top level, so without this a subcommand like `lt fullstack convert-mode
+            // --help` would actually RUN. The interceptor makes every command print
+            // help and return without executing when help is requested.
+            (0, command_help_1.installHelpInterceptor)(cli.commands, cli.defaultCommand);
             // Run cli
             const toolbox = yield cli.run(argv);
             // Record command in history (if history extension is available)

package/build/commands/dev/doctor.js

@@ -12,8 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
 const caddy_1 = require("../../lib/caddy");
 const dev_process_1 = require("../../lib/dev-process");
+const dev_project_1 = require("../../lib/dev-project");
 const dev_service_1 = require("../../lib/dev-service");
 const dev_state_1 = require("../../lib/dev-state");
+const dev_ticket_1 = require("../../lib/dev-ticket");
 /**
  * Diagnose Caddy / CA / DNS / port issues for `lt dev`.
  *
@@ -30,7 +32,7 @@ const DoctorCommand = {
     hidden: false,
     name: 'doctor',
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        const { parameters, print: { colors, info }, } = toolbox;
+        const { filesystem, parameters, print: { colors, info }, } = toolbox;
         info('');
         info(colors.bold('lt dev doctor'));
         info(colors.dim('─'.repeat(60)));
@@ -105,6 +107,30 @@ const DoctorCommand = {
         const reg = (0, dev_state_1.loadRegistry)();
         const count = Object.keys(reg.projects).length;
         line('OK', colors.green, `registry: ${count} project(s) at ${dev_state_1.paths.registry}`);
+        // 7. Project-level (only when run inside a project): is a DB-wiping
+        //    Playwright global-setup ticket/shard-safe? WARN (never auto-edit) if a
+        //    bespoke allow-list would reject the per-ticket/shard `<base>-<id>-test`
+        //    DBs that `lt ticket` / `lt dev test --shard` create.
+        const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
+        if (layout.apiDir || layout.appDir) {
+            const gs = (0, dev_ticket_1.checkGlobalSetupTicketSafe)(layout);
+            if (gs.file && gs.hasDbReset && !gs.ticketSafe) {
+                line('WARN', colors.yellow, 'global-setup allow-list rejects per-ticket/shard test DBs — `lt ticket` / `--shard` E2E cannot reset its DB');
+                line('WARN', colors.yellow, `  ${gs.file}: widen isAllowedDb → /^<base>-(?:[a-z0-9-]+-)?test(?:-\\d+)?$/  (svl is the reference)`);
+            }
+            else if (gs.file && gs.hasDbReset) {
+                line('OK', colors.green, 'global-setup allow-list is ticket + shard safe');
+            }
+            // 8. Slug ↔ path: is this project's slug registered to a DIFFERENT checkout?
+            //    Two clones of the same project (same package.json "name") share the
+            //    slug → Caddy block / ports / DB and collide. Surface it proactively.
+            const { identity } = (0, dev_ticket_1.resolveDevIdentity)(layout);
+            const conflict = (0, dev_state_1.detectSlugConflict)(identity.slug, layout.root);
+            if (conflict) {
+                line('WARN', colors.yellow, `slug "${identity.slug}" is also registered to another checkout${conflict.otherSessionAlive ? ' (currently RUNNING)' : ''}: ${conflict.otherPath}`);
+                line('WARN', colors.yellow, '  two clones of the same project collide on URLs/ports/DB — rename one package.json "name", or run only one.');
+            }
+        }
         info('');
         if (fails > 0)
             info(colors.red(`✗ ${fails} fail(s) — see above`));

package/build/commands/dev/down.js

@@ -11,11 +11,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const caddy_1 = require("../../lib/caddy");
 const dev_env_bridge_1 = require("../../lib/dev-env-bridge");
-const dev_identity_1 = require("../../lib/dev-identity");
 const dev_process_1 = require("../../lib/dev-process");
 const dev_project_1 = require("../../lib/dev-project");
 const dev_state_1 = require("../../lib/dev-state");
 const dev_test_session_1 = require("../../lib/dev-test-session");
+const dev_ticket_1 = require("../../lib/dev-ticket");
 /**
  * Stop the processes started by `lt dev up` and remove the project's
  * Caddy block.
@@ -33,7 +33,9 @@ const DownCommand = {
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
         const { filesystem, parameters, print: { colors, info, success, warning }, } = toolbox;
         const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
-        const identity = (0, dev_identity_1.buildIdentity)(layout.root);
+        // Ticket-aware: in a ticket worktree the slug / Caddy block / test stack are
+        // suffixed (`<slug>-<id>`), so resolve the same identity `up` used.
+        const { identity } = (0, dev_ticket_1.resolveDevIdentity)(layout, { ticket: parameters.options.ticket });
         const session = (0, dev_state_1.loadSession)(layout.root);
         const stopped = [];
         if (session) {
@@ -54,14 +56,24 @@ const DownCommand = {
         else {
             info(colors.dim('No running processes registered for this project.'));
         }
-        // Remove Caddy block (best-effort — even if no session was active).
-        const removed = (0, caddy_1.removeProjectBlock)(identity.slug);
-        if (removed) {
-            const r = yield (0, caddy_1.reloadCaddy)();
-            if (r.ok)
-                success(`Removed Caddy block for "${identity.slug}".`);
-            else
-                warning(`Removed Caddy block but reload failed: ${r.stderr.split('\n')[0]}`);
+        // Don't clobber another checkout: when this slug is registered to a DIFFERENT
+        // checkout (two clones of the same project share a package.json "name" → slug),
+        // the Caddy block + registration belong to IT — stop only OUR processes
+        // (above) and leave its routing intact. Otherwise remove the block as usual.
+        const conflict = (0, dev_state_1.detectSlugConflict)(identity.slug, layout.root);
+        if (conflict) {
+            warning(`Slug "${identity.slug}" is registered to another checkout — leaving its Caddy block + registration untouched:`);
+            info(colors.dim(`  ${conflict.otherPath}`));
+        }
+        else {
+            const removed = (0, caddy_1.removeProjectBlock)(identity.slug);
+            if (removed) {
+                const r = yield (0, caddy_1.reloadCaddy)();
+                if (r.ok)
+                    success(`Removed Caddy block for "${identity.slug}".`);
+                else
+                    warning(`Removed Caddy block but reload failed: ${r.stderr.split('\n')[0]}`);
+            }
         }
         // Clear ENV bridge so subsequent test runs without `lt dev up`
         // do not pick up stale URLs.

package/build/commands/dev/status.js

@@ -10,10 +10,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const caddy_1 = require("../../lib/caddy");
-const dev_identity_1 = require("../../lib/dev-identity");
 const dev_process_1 = require("../../lib/dev-process");
 const dev_project_1 = require("../../lib/dev-project");
 const dev_state_1 = require("../../lib/dev-state");
+const dev_ticket_1 = require("../../lib/dev-ticket");
 /**
  * Show what is running.
  *
@@ -56,10 +56,11 @@ const StatusCommand = {
             return 'dev status: all';
         }
         const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
-        const identity = (0, dev_identity_1.buildIdentity)(layout.root);
+        // Ticket-aware: a ticket worktree reports its OWN suffixed stack.
+        const { identity, ticket } = (0, dev_ticket_1.resolveDevIdentity)(layout, { ticket: parameters.options.ticket });
         const entry = reg.projects[identity.slug];
         info('');
-        info(colors.bold(`lt dev status: ${identity.slug}`));
+        info(colors.bold(`lt dev status: ${identity.slug}`) + (ticket ? colors.dim(` (ticket ${ticket})`) : ''));
         info(colors.dim('─'.repeat(60)));
         if (!entry) {
             warning('Not registered. Run `lt dev init` first.');

package/build/commands/dev/test.js

@@ -12,10 +12,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = require("fs");
 const caddy_1 = require("../../lib/caddy");
 const dev_env_bridge_1 = require("../../lib/dev-env-bridge");
-const dev_identity_1 = require("../../lib/dev-identity");
 const dev_process_1 = require("../../lib/dev-process");
 const dev_project_1 = require("../../lib/dev-project");
 const dev_test_session_1 = require("../../lib/dev-test-session");
+const dev_ticket_1 = require("../../lib/dev-ticket");
 /**
  * One-shot E2E convenience wrapper.
  *
@@ -54,7 +54,10 @@ const TestCommand = {
                 process.exit(1);
             return 'dev test: not a project';
         }
-        const identity = (0, dev_identity_1.buildIdentity)(layout.root);
+        // Ticket-aware: a ticket worktree tests its OWN isolated stack + DB
+        // (`<slug>-<id>-test`), so resolve the ticket identity + pass the ticket dev
+        // DB so the test DB is derived per ticket (never shared between tickets).
+        const { dbName: devDbName, identity } = (0, dev_ticket_1.resolveDevIdentity)(layout, { ticket: parameters.options.ticket });
         const log = { dim: colors.dim, info, warn: warning };
         // Sub-command: `lt dev test down` — tear the test stack(s) down + exit.
         // Reclaims both the unsharded stack and any leftover sharded stacks.
@@ -171,7 +174,12 @@ const TestCommand = {
             try {
                 info('');
                 info(colors.bold(`Running isolated Playwright E2E for "${identity.slug}" sharded across ${shardTotal} stacks`));
-                shardExit = yield (0, dev_test_session_1.runShardedTestSession)(layout, identity, log, { forwarded, pnpmBin, total: shardTotal });
+                shardExit = yield (0, dev_test_session_1.runShardedTestSession)(layout, identity, log, {
+                    devDbName,
+                    forwarded,
+                    pnpmBin,
+                    total: shardTotal,
+                });
             }
             catch (e) {
                 error(`Failed to run sharded E2E: ${e.message}`);
@@ -213,7 +221,7 @@ const TestCommand = {
         process.on('SIGTERM', onSignal);
         let exitCode = 1;
         try {
-            const ctx = yield (0, dev_test_session_1.bringUpTestSession)(layout, identity, log);
+            const ctx = yield (0, dev_test_session_1.bringUpTestSession)(layout, identity, log, { devDbName });
             const env = Object.assign(Object.assign(Object.assign({}, process.env), readBridgeEnv(layout.root)), { 
                 // Playwright global-setup resets THIS db (allow-listed) before the suite.
                 MONGO_URI: `mongodb://127.0.0.1/${ctx.dbName}` });

package/build/commands/dev/up.js

@@ -14,11 +14,11 @@ const path_1 = require("path");
 const caddy_1 = require("../../lib/caddy");
 const dev_env_1 = require("../../lib/dev-env");
 const dev_env_bridge_1 = require("../../lib/dev-env-bridge");
-const dev_identity_1 = require("../../lib/dev-identity");
 const dev_patches_1 = require("../../lib/dev-patches");
 const dev_process_1 = require("../../lib/dev-process");
 const dev_project_1 = require("../../lib/dev-project");
 const dev_state_1 = require("../../lib/dev-state");
+const dev_ticket_1 = require("../../lib/dev-ticket");
 /**
  * Start API + App behind Caddy with project-specific URLs.
  *
@@ -81,7 +81,7 @@ const UpCommand = {
     hidden: false,
     name: 'up',
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         const { filesystem, parameters, print: { colors, error, info, success, warning }, } = toolbox;
         const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
         if (!layout.apiDir && !layout.appDir) {
@@ -103,21 +103,48 @@ const UpCommand = {
                 process.exit(1);
             return 'dev up: caddy daemon down';
         }
-        const identity = (0, dev_identity_1.buildIdentity)(layout.root);
-        const dbName = (0, dev_project_1.deriveDbName)(layout.apiDir, identity.slug);
+        // Ticket-aware: in a `lt ticket` worktree (tagged by a `.lt-dev/ticket`
+        // marker) — or with an explicit `--ticket <name>` — the slug / URLs / DB are
+        // suffixed so the stack is fully isolated from the base dev session and every
+        // other ticket. Without a ticket this is the plain project identity.
+        const { dbName, identity, ticket } = (0, dev_ticket_1.resolveDevIdentity)(layout, { ticket: parameters.options.ticket });
+        // Guard against two checkouts of the SAME project (same package.json "name"
+        // → same slug → shared URLs / ports / DB / Caddy block). If another checkout
+        // is already RUNNING under this slug, abort with a clear message — otherwise
+        // both fight over the same ports and one `lt dev down` unroutes the other.
+        {
+            const conflict = (0, dev_state_1.detectSlugConflict)(identity.slug, layout.root);
+            if (conflict === null || conflict === void 0 ? void 0 : conflict.otherSessionAlive) {
+                error(`Slug "${identity.slug}" is already in use by another RUNNING checkout:`);
+                info(colors.dim(`  ${conflict.otherPath}`));
+                info('Two checkouts of the same project share URLs / ports / database and collide.');
+                info('Stop it there (`lt dev down`), or give THIS checkout a distinct package.json "name".');
+                if (!parameters.options.fromGluegunMenu)
+                    process.exit(1);
+                return 'dev up: slug in use by another checkout';
+            }
+        }
         // Sanft auto-migrate sichere Operationen (ohne Code-Modifikation):
         // CLAUDE.md-URL-Block einfügen + .gitignore ergänzen.
         // Code-Patches (config.env.ts, nuxt.config.ts) bleiben explizit `lt dev init`.
         {
-            const claudeCandidates = [
-                (0, path_1.join)(layout.root, 'CLAUDE.md'),
-                ...(layout.apiDir ? [(0, path_1.join)(layout.apiDir, 'CLAUDE.md')] : []),
-                ...(layout.appDir ? [(0, path_1.join)(layout.appDir, 'CLAUDE.md')] : []),
-            ];
-            const patched = claudeCandidates.map((f) => (0, dev_patches_1.patchClaudeMd)(f, { dbName, identity })).filter((r) => r.patched);
-            if (patched.length > 0) {
-                info(colors.dim(`updated CLAUDE.md URL block in ${patched.length} file(s)`));
+            // NEVER patch the git-tracked CLAUDE.md for a ticket worktree: it would
+            // differ per worktree and risk committing ticket-specific URLs. The lt-dev
+            // plugin hook surfaces the ticket context per prompt instead (from the
+            // gitignored `.lt-dev/ticket` marker). For the base project we keep the
+            // committed URL block up to date as before.
+            if (!ticket) {
+                const claudeCandidates = [
+                    (0, path_1.join)(layout.root, 'CLAUDE.md'),
+                    ...(layout.apiDir ? [(0, path_1.join)(layout.apiDir, 'CLAUDE.md')] : []),
+                    ...(layout.appDir ? [(0, path_1.join)(layout.appDir, 'CLAUDE.md')] : []),
+                ];
+                const patched = claudeCandidates.map((f) => (0, dev_patches_1.patchClaudeMd)(f, { dbName, identity })).filter((r) => r.patched);
+                if (patched.length > 0) {
+                    info(colors.dim(`updated CLAUDE.md URL block in ${patched.length} file(s)`));
+                }
             }
+            // Always keep `.lt-dev/` (state, env bridge, ticket marker) out of git.
             if ((0, dev_patches_1.addToGitignore)(layout.root, '.lt-dev/')) {
                 info(colors.dim('added `.lt-dev/` to .gitignore'));
             }
@@ -154,7 +181,7 @@ const UpCommand = {
                     apiUpstreamPort: existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.internalPorts.api,
                     appHostname: (_d = identity.subdomains.app) === null || _d === void 0 ? void 0 : _d.hostname,
                     appUpstreamPort: existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.internalPorts.app,
-                    dbName: (_e = existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.dbName) !== null && _e !== void 0 ? _e : (0, dev_project_1.deriveDbName)(layout.apiDir, identity.slug),
+                    dbName: (_e = existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.dbName) !== null && _e !== void 0 ? _e : dbName,
                 });
                 info('Run `lt dev down` first.');
                 if (!parameters.options.fromGluegunMenu)
@@ -162,25 +189,48 @@ const UpCommand = {
                 return 'dev up: already running';
             }
         }
-        // Allocate internal ports (reuse existing if registered).
-        const reg = (0, dev_state_1.loadRegistry)();
-        const entry = reg.projects[identity.slug];
-        const taken = (0, dev_state_1.takenInternalPorts)(reg, identity.slug);
-        const apiPort = (_f = entry === null || entry === void 0 ? void 0 : entry.internalPorts.api) !== null && _f !== void 0 ? _f : (layout.apiDir ? (0, dev_state_1.allocateInternalPort)(4000, taken) : undefined);
-        if (apiPort)
-            taken.add(apiPort);
-        const appPort = (_g = entry === null || entry === void 0 ? void 0 : entry.internalPorts.app) !== null && _g !== void 0 ? _g : (layout.appDir ? (0, dev_state_1.allocateInternalPort)(4000, taken) : undefined);
-        // Pre-flight: internal ports free?
-        const portsToCheck = [apiPort, appPort].filter((p) => typeof p === 'number');
-        const snap = yield (0, dev_process_1.listenSnapshot)(portsToCheck);
-        for (const p of portsToCheck) {
-            const r = snap.get(p);
-            if (r) {
-                error(`Internal port ${p} already in use by ${r.command} (pid ${r.pid}).`);
-                if (!parameters.options.fromGluegunMenu)
-                    process.exit(1);
-                return 'dev up: port in use';
-            }
+        // Allocate internal ports (reuse existing if registered), verify they are
+        // free, AND reserve them in the registry — all ATOMICALLY under a cross-
+        // process lock, so two simultaneous `lt ticket start` (each → `lt dev up`)
+        // can never grab the same ports.
+        let apiPort;
+        let appPort;
+        try {
+            yield (0, dev_state_1.withRegistryLock)(() => __awaiter(void 0, void 0, void 0, function* () {
+                var _a, _b;
+                const reg = (0, dev_state_1.loadRegistry)();
+                const entry = reg.projects[identity.slug];
+                const taken = (0, dev_state_1.takenInternalPorts)(reg, identity.slug);
+                apiPort = (_a = entry === null || entry === void 0 ? void 0 : entry.internalPorts.api) !== null && _a !== void 0 ? _a : (layout.apiDir ? (0, dev_state_1.allocateInternalPort)(4000, taken) : undefined);
+                if (apiPort)
+                    taken.add(apiPort);
+                appPort = (_b = entry === null || entry === void 0 ? void 0 : entry.internalPorts.app) !== null && _b !== void 0 ? _b : (layout.appDir ? (0, dev_state_1.allocateInternalPort)(4000, taken) : undefined);
+                const portsToCheck = [apiPort, appPort].filter((p) => typeof p === 'number');
+                const snap = yield (0, dev_process_1.listenSnapshot)(portsToCheck);
+                for (const p of portsToCheck) {
+                    const r = snap.get(p);
+                    if (r)
+                        throw new Error(`Internal port ${p} already in use by ${r.command} (pid ${r.pid}).`);
+                }
+                // Reserve immediately so a concurrent `lt dev up` sees these as taken.
+                const subdomainMap = {};
+                for (const [k, v] of Object.entries(identity.subdomains))
+                    subdomainMap[k] = v.hostname;
+                reg.projects[identity.slug] = {
+                    dbName,
+                    internalPorts: { api: apiPort, app: appPort },
+                    lastUsedAt: new Date().toISOString(),
+                    path: layout.root,
+                    subdomains: subdomainMap,
+                };
+                (0, dev_state_1.saveRegistry)(reg);
+            }));
+        }
+        catch (e) {
+            error(e.message);
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'dev up: port in use';
         }
         // Caddy block + reload.
         const routes = [];
@@ -203,7 +253,7 @@ const UpCommand = {
             return 'dev up: caddy reload failed';
         }
         info('');
-        info(colors.bold(`Starting "${identity.slug}"`));
+        info(colors.bold(`Starting "${identity.slug}"`) + (ticket ? colors.dim(` (ticket ${ticket})`) : ''));
         if (identity.subdomains.app)
             info(`  app: https://${identity.subdomains.app.hostname}  →  127.0.0.1:${appPort}`);
         if (identity.subdomains.api)
@@ -230,7 +280,7 @@ const UpCommand = {
             if (apiResult) {
                 pids.api = apiResult.pid;
                 if (apiResult.rotated.rotated && apiResult.rotated.archivePath !== undefined) {
-                    rotationNotes.push(formatRotationNote('api', apiResult.rotated.archivePath, (_h = apiResult.rotated.previousSize) !== null && _h !== void 0 ? _h : 0));
+                    rotationNotes.push(formatRotationNote('api', apiResult.rotated.archivePath, (_f = apiResult.rotated.previousSize) !== null && _f !== void 0 ? _f : 0));
                 }
             }
         }
@@ -243,35 +293,25 @@ const UpCommand = {
             if (appResult) {
                 pids.app = appResult.pid;
                 if (appResult.rotated.rotated && appResult.rotated.archivePath !== undefined) {
-                    rotationNotes.push(formatRotationNote('app', appResult.rotated.archivePath, (_j = appResult.rotated.previousSize) !== null && _j !== void 0 ? _j : 0));
+                    rotationNotes.push(formatRotationNote('app', appResult.rotated.archivePath, (_g = appResult.rotated.previousSize) !== null && _g !== void 0 ? _g : 0));
                 }
             }
         }
-        // Persist.
-        const subdomainMap = {};
-        for (const [k, v] of Object.entries(identity.subdomains))
-            subdomainMap[k] = v.hostname;
-        reg.projects[identity.slug] = {
-            dbName,
-            internalPorts: { api: apiPort, app: appPort },
-            lastUsedAt: new Date().toISOString(),
-            path: layout.root,
-            subdomains: subdomainMap,
-        };
-        (0, dev_state_1.saveRegistry)(reg);
+        // Persist the session (PIDs). The registry entry (ports) was already reserved
+        // atomically before the spawn, above.
         (0, dev_state_1.saveSession)(layout.root, { pids, startedAt: new Date().toISOString() });
         // Write the ENV bridge so external tools (Playwright, IDE test runners,
         // custom shell scripts) can pick up the URLs without inheriting our shell.
         const bridgePath = (0, dev_env_bridge_1.writeEnvBridge)(layout.root, devEnv, dbName);
         info(colors.dim(`ENV bridge: ${bridgePath}`));
-        success(`Started: api pid=${(_k = pids.api) !== null && _k !== void 0 ? _k : '-'}, app pid=${(_l = pids.app) !== null && _l !== void 0 ? _l : '-'}`);
+        success(`Started: api pid=${(_h = pids.api) !== null && _h !== void 0 ? _h : '-'}, app pid=${(_j = pids.app) !== null && _j !== void 0 ? _j : '-'}`);
         // Echo the bound URLs next to the PIDs as well — the "Starting" block
         // prints them before the spawn, but on a long boot log they scroll out
         // of view, so repeating them here keeps PID + URL visually grouped.
         printProjectUrls(info, {
-            apiHostname: (_m = identity.subdomains.api) === null || _m === void 0 ? void 0 : _m.hostname,
+            apiHostname: (_k = identity.subdomains.api) === null || _k === void 0 ? void 0 : _k.hostname,
             apiUpstreamPort: apiPort,
-            appHostname: (_o = identity.subdomains.app) === null || _o === void 0 ? void 0 : _o.hostname,
+            appHostname: (_l = identity.subdomains.app) === null || _l === void 0 ? void 0 : _l.hostname,
             appUpstreamPort: appPort,
             dbName,
         });

package/build/commands/frontend/angular.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const workspace_integration_1 = require("../../lib/workspace-integration");
 /**
  * Create a new Angular workspace
@@ -18,6 +19,52 @@ const workspace_integration_1 = require("../../lib/workspace-integration");
  * Mirrors the same dry-run / workspace-detection surface as the Nuxt
  * sibling so behaviour is consistent across the four flows.
  */
+exports.help = {
+    aliases: ['a'],
+    configuration: 'commands.frontend.angular.*',
+    description: 'Create a new Angular workspace from ng-base-starter',
+    name: 'angular',
+    options: [
+        { description: 'Workspace name', flag: '--name', required: false, type: 'string' },
+        { description: 'Branch of ng-base-starter to clone', flag: '--branch', required: false, type: 'string' },
+        { description: 'Copy from local template directory', flag: '--copy', required: false, type: 'string' },
+        { description: 'Symlink to local template directory', flag: '--link', required: false, type: 'string' },
+        { description: 'Initialize Angular localize', flag: '--localize', required: false, type: 'boolean' },
+        {
+            description: 'Skip Angular localize initialisation',
+            flag: '--noLocalize',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            description: 'Git remote URL to push initial commit to',
+            flag: '--gitLink',
+            required: false,
+            type: 'string',
+        },
+        {
+            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',
+            flag: '--noConfirm',
+            required: false,
+            type: 'boolean',
+        },
+    ],
+};
 const NewCommand = {
     alias: ['a'],
     description: 'Create Angular workspace',
@@ -27,52 +74,7 @@ const NewCommand = {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         // Retrieve the tools we need
         const { config, filesystem, frontendHelper, git, helper, parameters, print: { error, info, spin, success }, prompt: { confirm }, strings: { kebabCase }, system, } = toolbox;
-        if (toolbox.tools.helpJson({
-            aliases: ['a'],
-            configuration: 'commands.frontend.angular.*',
-            description: 'Create a new Angular workspace from ng-base-starter',
-            name: 'angular',
-            options: [
-                { description: 'Workspace name', flag: '--name', required: false, type: 'string' },
-                { description: 'Branch of ng-base-starter to clone', flag: '--branch', required: false, type: 'string' },
-                { description: 'Copy from local template directory', flag: '--copy', required: false, type: 'string' },
-                { description: 'Symlink to local template directory', flag: '--link', required: false, type: 'string' },
-                { description: 'Initialize Angular localize', flag: '--localize', required: false, type: 'boolean' },
-                {
-                    description: 'Skip Angular localize initialisation',
-                    flag: '--noLocalize',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    description: 'Git remote URL to push initial commit to',
-                    flag: '--gitLink',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    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',
-                    flag: '--noConfirm',
-                    required: false,
-                    type: 'boolean',
-                },
-            ],
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         // Load configuration

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

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const frontend_framework_detection_1 = require("../../lib/frontend-framework-detection");
 /**
  * Convert an existing frontend project between npm mode and vendor mode.
@@ -17,6 +18,45 @@ const frontend_framework_detection_1 = require("../../lib/frontend-framework-det
  *   lt frontend convert-mode --to vendor [--upstream-branch 1.5.3]
  *   lt frontend convert-mode --to npm [--version 1.5.3]
  */
+exports.help = {
+    description: 'Convert frontend 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: 'nuxt-extensions 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',
+        },
+    ],
+};
 const ConvertModeCommand = {
     description: 'Convert app framework mode',
     hidden: false,
@@ -24,45 +64,7 @@ const ConvertModeCommand = {
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
         const { filesystem, frontendHelper, parameters, print: { error, info, spin, success, warning }, prompt: { confirm }, } = toolbox;
         // Handle --help-json flag
-        if (toolbox.tools.helpJson({
-            description: 'Convert frontend 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: 'nuxt-extensions 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',
-                },
-            ],
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         const targetMode = parameters.options.to;