@lenne.tech/cli 1.27.0 → 1.28.0

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/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;