@lenne.tech/cli 1.26.1 → 1.28.0

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/ticket/list.js

@@ -0,0 +1,78 @@
+"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 dev_identity_1 = require("../../lib/dev-identity");
+const dev_project_1 = require("../../lib/dev-project");
+const dev_state_1 = require("../../lib/dev-state");
+const dev_ticket_1 = require("../../lib/dev-ticket");
+/**
+ * `lt ticket list` — the dashboard of all active ticket worktrees: id, folder,
+ * branch, URLs, DB and running state. The one place to re-view every ticket's
+ * URLs at any time.
+ */
+const ListCommand = {
+    alias: ['ls'],
+    description: 'List all ticket worktrees with their URLs + status',
+    name: 'list',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { filesystem, parameters, print: { colors, info, warning }, } = toolbox;
+        const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
+        let mainRepoRoot;
+        try {
+            mainRepoRoot = (0, dev_ticket_1.gitMainRepoRoot)(layout.root);
+        }
+        catch (_b) {
+            warning('Not inside a git repository.');
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket list: not a git repo';
+        }
+        const base = (0, dev_identity_1.buildIdentity)(mainRepoRoot);
+        const tickets = (0, dev_ticket_1.listWorktrees)(mainRepoRoot).filter((w) => w.ticket);
+        const reg = (0, dev_state_1.loadRegistry)();
+        info('');
+        info(colors.bold('Ticket environments'));
+        info(colors.dim('─'.repeat(64)));
+        if (tickets.length === 0) {
+            info(colors.dim('  none — start one with `lt ticket start <ticket-or-name>`'));
+            info('');
+            if (!parameters.options.fromGluegunMenu)
+                process.exit();
+            return 'ticket list: empty';
+        }
+        for (const wt of tickets) {
+            const session = (0, dev_state_1.loadSession)(wt.path);
+            const apiAlive = (session === null || session === void 0 ? void 0 : session.pids.api) ? (0, dev_state_1.isPidAlive)(session.pids.api) : false;
+            const appAlive = (session === null || session === void 0 ? void 0 : session.pids.app) ? (0, dev_state_1.isPidAlive)(session.pids.app) : false;
+            const running = apiAlive || appAlive;
+            const dot = running ? colors.green('●') : colors.dim('○');
+            // The dev stack for this ticket is registered under `<base>-<id>`.
+            const entry = reg.projects[`${base.slug}-${wt.ticket}`];
+            info(`  ${dot} ${colors.bold(String(wt.ticket).padEnd(16))} ${colors.dim(`branch ${(_a = wt.branch) !== null && _a !== void 0 ? _a : '-'}`)}`);
+            if (entry) {
+                for (const [sub, host] of Object.entries(entry.subdomains))
+                    info(`       ${sub.padEnd(4)} https://${host}`);
+                if (entry.dbName)
+                    info(`       db   mongodb://127.0.0.1/${entry.dbName}`);
+            }
+            info(colors.dim(`       dir  ${wt.path}`));
+            info(colors.dim(`       ${running ? 'running' : 'stopped'}${entry ? '' : ' (not brought up yet)'}`));
+        }
+        info('');
+        info(colors.dim('Open: `code <dir>` / `lt ticket switch <id>` · Test: `lt ticket test <id>` · Stop: `lt ticket stop <id>`'));
+        info('');
+        if (!parameters.options.fromGluegunMenu)
+            process.exit();
+        return `ticket list: ${tickets.length}`;
+    }),
+};
+module.exports = ListCommand;

package/build/commands/ticket/start.js

@@ -0,0 +1,141 @@
+"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 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");
+/**
+ * `lt ticket start <name>` — spin up a fully-isolated parallel dev environment
+ * for a ticket or feature, in seconds:
+ *
+ *   1. `git fetch` + create a git WORKTREE on a fresh branch from `origin/dev`
+ *      (so every ticket starts independent from the latest dev) at a sibling
+ *      folder `<parent>/<slug>-<id>`,
+ *   2. tag it with a `.lt-dev/ticket` marker (makes every `lt dev *` in it
+ *      ticket-aware),
+ *   3. `pnpm install` (hard-links from the shared store → fast),
+ *   4. `lt dev up` → own URLs (`<slug>-<id>.localhost` / `api.<slug>-<id>…`),
+ *      own ports, own Caddy block, own EMPTY DB (`<base>-<id>`).
+ *
+ *   lt ticket start DEV-2200            → svl-2200.localhost      (branch feat/DEV-2200)
+ *   lt ticket start checkout-refactor   → svl-checkout-refactor.localhost
+ *   lt ticket start DEV-2200 --as cof   → svl-cof.localhost
+ */
+const StartCommand = {
+    description: 'Start an isolated parallel dev env for a ticket/feature (worktree + lt dev up)',
+    name: 'start',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { filesystem, parameters, print: { colors, error, info, success, warning }, } = toolbox;
+        // `String(...)` — a purely-numeric arg (e.g. a ticket "9991") is parsed as a
+        // JS number by the option parser, on which `.trim()` would throw.
+        const name = String((_a = parameters.first) !== null && _a !== void 0 ? _a : '').trim();
+        if (!name) {
+            error('Usage: lt ticket start <ticket-or-name> [--as <id>] [--branch <branch>] [--base <ref>]');
+            info(colors.dim('  e.g. lt ticket start DEV-2200    |    lt ticket start checkout-refactor'));
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket start: missing name';
+        }
+        // Anchor to the MAIN repo (works even when invoked from inside a worktree).
+        const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
+        let mainRepoRoot;
+        try {
+            mainRepoRoot = (0, dev_ticket_1.gitMainRepoRoot)(layout.root);
+        }
+        catch (_b) {
+            error('Not inside a git repository — `lt ticket` needs a git project.');
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket start: not a git repo';
+        }
+        const base = (0, dev_identity_1.buildIdentity)(mainRepoRoot);
+        const id = (0, dev_ticket_1.deriveTicketId)(name, parameters.options.as != null ? String(parameters.options.as) : undefined);
+        const branch = typeof parameters.options.branch === 'string' ? parameters.options.branch : (0, dev_ticket_1.defaultTicketBranch)(name);
+        const baseRef = typeof parameters.options.base === 'string' ? parameters.options.base : 'origin/dev';
+        const ticketIdentity = (0, dev_identity_1.buildTicketIdentity)(base, id);
+        const dbName = (0, dev_project_1.deriveTicketDbName)((0, dev_project_1.deriveDbName)(layout.apiDir, base.slug), id);
+        const worktreePath = (0, dev_ticket_1.worktreePathFor)(mainRepoRoot, base.slug, id);
+        // Pre-flight: nothing already there + slug free.
+        if ((0, fs_1.existsSync)(worktreePath)) {
+            error(`Target folder already exists: ${worktreePath}`);
+            info(colors.dim('  Use a different id (`--as <id>`) or remove it with `lt ticket stop`.'));
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket start: path exists';
+        }
+        if ((0, dev_state_1.loadRegistry)().projects[ticketIdentity.slug]) {
+            warning(`An env named "${ticketIdentity.slug}" is already registered — choose another id with --as.`);
+        }
+        info('');
+        info(colors.bold(`Starting ticket "${id}"  →  ${ticketIdentity.slug}`));
+        info(colors.dim(`  branch:   ${branch}  (from ${baseRef})`));
+        info(colors.dim(`  worktree: ${worktreePath}`));
+        info('');
+        // 1. fetch + worktree (fresh branch from origin/dev → independent).
+        try {
+            info(colors.dim(`Fetching + creating worktree from ${baseRef} …`));
+            (0, dev_ticket_1.gitFetch)(mainRepoRoot);
+            (0, dev_ticket_1.worktreeAdd)(mainRepoRoot, worktreePath, branch, baseRef);
+        }
+        catch (e) {
+            error(`git worktree setup failed: ${e.message}`);
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket start: worktree failed';
+        }
+        // 2. tag the worktree with its ticket id (makes lt dev * ticket-aware).
+        (0, dev_ticket_1.writeTicketMarker)(worktreePath, id);
+        // 3. install deps (pnpm hard-links from the shared store → fast).
+        if (parameters.options.install !== false) {
+            info(colors.dim('Installing dependencies (pnpm) …'));
+            try {
+                (0, dev_ticket_1.pnpmInstall)(worktreePath);
+            }
+            catch (e) {
+                warning(`pnpm install failed (${e.message}) — continuing; run it manually in the worktree.`);
+            }
+        }
+        // 4. bring the isolated stack up (re-invokes THIS lt build so the marker is
+        //    honoured even before a global recompile). `--no-up` just scaffolds.
+        if (parameters.options.up !== false) {
+            info('');
+            info(colors.dim('Bringing up the isolated stack (lt dev up) …'));
+            const code = yield (0, dev_process_1.runChildInherit)(process.execPath, [process.argv[1], 'dev', 'up'], {
+                cwd: worktreePath,
+                env: process.env,
+            });
+            if (code !== 0)
+                warning(`lt dev up exited ${code} — inspect with \`cd ${worktreePath} && lt dev status\`.`);
+        }
+        // Summary — the URLs the user works with (always re-viewable via `lt ticket list`).
+        info('');
+        success(`Ticket "${id}" ready.`);
+        if (ticketIdentity.subdomains.app)
+            info(`  app: https://${ticketIdentity.subdomains.app.hostname}`);
+        if (ticketIdentity.subdomains.api)
+            info(`  api: https://${ticketIdentity.subdomains.api.hostname}`);
+        info(`  db:  mongodb://127.0.0.1/${dbName}  (empty)`);
+        info(`  dir: ${worktreePath}`);
+        info('');
+        info(colors.dim(`Open it:   code ${worktreePath}    (or: lt ticket switch ${id})`));
+        info(colors.dim(`Test it:   cd ${worktreePath} && lt dev test    (or: lt ticket test ${id})`));
+        info(colors.dim('All envs:  lt ticket list'));
+        info(colors.dim(`Stop it:   lt ticket stop ${id}`));
+        if (!parameters.options.fromGluegunMenu)
+            process.exit();
+        return `ticket start: ${id}`;
+    }),
+};
+module.exports = StartCommand;

package/build/commands/ticket/stop.js

@@ -0,0 +1,166 @@
+"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 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");
+/**
+ * `lt ticket stop [<id>]` — tear a ticket env down + remove its worktree.
+ *
+ *   1. `lt dev down` inside the worktree (stops the ticket stack + any test
+ *      stacks, removes the Caddy block — residue-free),
+ *   2. `git worktree remove` (the BRANCH is kept, so nothing is lost),
+ *   3. `--drop-db` also drops the ticket's empty dev + test databases.
+ *
+ * Run with NO id from INSIDE a ticket worktree to clean up THIS environment
+ * (the current folder is removed; the process steps out to the main repo first).
+ */
+const StopCommand = {
+    alias: ['rm'],
+    description: 'Stop a ticket env + remove its worktree (branch kept); no id = the current worktree',
+    name: 'stop',
+    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const { filesystem, parameters, print: { colors, error, info, success, warning }, } = toolbox;
+        const layout = (0, dev_project_1.resolveLayout)(filesystem.cwd(), filesystem);
+        let mainRepoRoot;
+        try {
+            mainRepoRoot = (0, dev_ticket_1.gitMainRepoRoot)(layout.root);
+        }
+        catch (_f) {
+            error('Not inside a git repository.');
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket stop: not a git repo';
+        }
+        // Id from the argument — or, when invoked with NO id from INSIDE a ticket
+        // worktree, the current worktree's own ticket (so a bare `lt ticket stop`
+        // cleans up "this" environment and removes this very folder).
+        const fromMarker = parameters.first == null ? (0, dev_ticket_1.readTicketMarker)(layout.root) : null;
+        const id = String((_b = (_a = parameters.first) !== null && _a !== void 0 ? _a : fromMarker) !== null && _b !== void 0 ? _b : '').trim();
+        if (!id) {
+            error('Usage: lt ticket stop <id> [--drop-db] [--force]  — or run with no id from INSIDE a ticket worktree.');
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket stop: missing id';
+        }
+        const wt = (0, dev_ticket_1.listWorktrees)(mainRepoRoot).find((w) => w.ticket === id);
+        if (!wt) {
+            error(`No ticket worktree "${id}" found. See \`lt ticket list\`.`);
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket stop: not found';
+        }
+        // SAFETY: never silently delete unsaved work. Warn + REFUSE (unless --force)
+        // when the worktree has uncommitted changes OR unpushed commits, so the user
+        // commits + pushes first. (`--force` removes anyway; the branch is kept, so
+        // committed history survives regardless.)
+        const safety = (0, dev_ticket_1.worktreeSafetyReport)(wt.path);
+        if ((safety.dirtySource.length > 0 || safety.unpushed > 0) && parameters.options.force !== true) {
+            warning('');
+            warning(`Refusing to remove ticket "${id}" — work is not fully committed + pushed:`);
+            if (safety.dirtySource.length > 0) {
+                warning(`  • ${safety.dirtySource.length} uncommitted change(s) — would be LOST on removal:`);
+                safety.dirtySource.slice(0, 12).forEach((l) => info(colors.dim(`      ${l}`)));
+                if (safety.dirtySource.length > 12)
+                    info(colors.dim(`      … and ${safety.dirtySource.length - 12} more`));
+            }
+            if (safety.unpushed > 0) {
+                warning(`  • ${safety.unpushed} commit(s) on "${(_c = wt.branch) !== null && _c !== void 0 ? _c : '-'}" not pushed to any remote`);
+            }
+            info('');
+            info(colors.dim('  Commit + push first (the branch is kept), or re-run with --force to remove anyway.'));
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket stop: unsaved work (use --force)';
+        }
+        // If we are removing the worktree we are standing in, step the process out
+        // to the main repo first so git can remove the folder cleanly.
+        const removingCwd = fromMarker !== null || samePath(wt.path, layout.root);
+        if (removingCwd) {
+            try {
+                process.chdir(mainRepoRoot);
+            }
+            catch (_g) {
+                /* best-effort */
+            }
+        }
+        info('');
+        info(colors.bold(`Stopping ticket "${id}"`));
+        // 1. Tear the isolated stack down from inside the worktree (marker-aware).
+        info(colors.dim('  lt dev down …'));
+        yield (0, dev_process_1.runChildInherit)(process.execPath, [process.argv[1], 'dev', 'down'], { cwd: wt.path, env: process.env });
+        // 2. Optionally drop the ticket databases (they are otherwise just left empty).
+        if (parameters.options.dropDb === true || parameters.options['drop-db'] === true) {
+            const base = (0, dev_identity_1.buildIdentity)(mainRepoRoot);
+            const entry = (0, dev_state_1.loadRegistry)().projects[`${base.slug}-${id}`];
+            const mainLayout = (0, dev_project_1.resolveLayout)(mainRepoRoot, filesystem);
+            const devDb = (_d = entry === null || entry === void 0 ? void 0 : entry.dbName) !== null && _d !== void 0 ? _d : (0, dev_project_1.deriveTicketDbName)((0, dev_project_1.deriveDbName)(mainLayout.apiDir, base.slug), id);
+            const testDb = (0, dev_project_1.deriveTestDbName)(devDb);
+            for (const db of [devDb, testDb]) {
+                if ((0, dev_ticket_1.dropDatabase)(db))
+                    info(colors.dim(`  dropped db ${db}`));
+                else
+                    warning(`  could not drop db ${db} (mongosh missing or DB not reachable) — drop it manually if needed.`);
+            }
+        }
+        // 3. Remove the worktree (branch is kept). Auto-force when the ONLY dirty
+        //    files are framework-generated (e.g. `nuxt dev` rewrites the tracked
+        //    `.nuxtrc` on boot), which would otherwise block the remove — but NEVER
+        //    discard real source edits (those keep the non-forced remove, which
+        //    errors with a hint so unsaved work is never lost).
+        const force = parameters.options.force === true || (0, dev_ticket_1.worktreeDirtyOnlyGenerated)(wt.path);
+        if (force && parameters.options.force !== true) {
+            info(colors.dim('  (worktree had only generated files dirty, e.g. .nuxtrc — removing)'));
+        }
+        try {
+            (0, dev_ticket_1.worktreeRemove)(mainRepoRoot, wt.path, force);
+        }
+        catch (e) {
+            error(`git worktree remove failed: ${e.message}`);
+            info(colors.dim('  The worktree has uncommitted SOURCE changes — commit/stash them, or pass --force to discard.'));
+            if (!parameters.options.fromGluegunMenu)
+                process.exit(1);
+            return 'ticket stop: worktree remove failed';
+        }
+        // The whole env is gone now — drop the ticket's registry entry so its slug +
+        // reserved ports are reclaimed (`lt dev down` only ends the session, keeping
+        // the entry for a restart; `lt ticket stop` removes the env entirely).
+        {
+            const reg = (0, dev_state_1.loadRegistry)();
+            const ticketSlug = `${(0, dev_identity_1.buildIdentity)(mainRepoRoot).slug}-${id}`;
+            if (reg.projects[ticketSlug]) {
+                delete reg.projects[ticketSlug];
+                (0, dev_state_1.saveRegistry)(reg);
+            }
+        }
+        info('');
+        success(`Ticket "${id}" stopped — worktree removed, branch "${(_e = wt.branch) !== null && _e !== void 0 ? _e : '-'}" kept.`);
+        if (removingCwd)
+            info(colors.dim(`  This folder is gone — your shell is still in it. Run: cd ${mainRepoRoot}`));
+        if (!parameters.options.fromGluegunMenu)
+            process.exit();
+        return `ticket stop: ${id}`;
+    }),
+};
+/** True if two paths point at the same location (resolving symlinks, e.g. /tmp → /private/tmp). */
+function samePath(a, b) {
+    try {
+        return (0, fs_1.realpathSync)(a) === (0, fs_1.realpathSync)(b);
+    }
+    catch (_a) {
+        return a === b;
+    }
+}
+module.exports = StopCommand;