@lenne.tech/cli 1.21.0 → 1.23.0

package/build/lib/local-patches.js

@@ -1,175 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.autoPatch = autoPatch;
-exports.patchApiConfig = patchApiConfig;
-exports.patchClaudeMd = patchClaudeMd;
-exports.patchNuxtConfig = patchNuxtConfig;
-exports.patchPlaywrightConfig = patchPlaywrightConfig;
-/**
- * Idempotent patches for legacy projects that still have hardcoded
- * dev ports. Applied by `lt local init --patch`.
- *
- * Each patch is a regex-based replace that matches only the legacy
- * form. Already-patched files are no-ops.
- */
-const fs_1 = require("fs");
-/** Run the appropriate patch based on filename. */
-function autoPatch(file) {
-    if (file.endsWith('config.env.ts'))
-        return patchApiConfig(file);
-    if (file.endsWith('nuxt.config.ts'))
-        return patchNuxtConfig(file);
-    if (file.endsWith('playwright.config.ts'))
-        return patchPlaywrightConfig(file);
-    return { file, patched: false, replacements: 0 };
-}
-/**
- * Patch nest-server-starter-style `src/config.env.ts`:
- * - `port: 3000,` → `port: Number(process.env.PORT) || 3000,`
- *
- * Idempotent — files already patched return `patched: false`. Missing
- * files are also a no-op (matches `patchClaudeMd` behavior).
- */
-function patchApiConfig(file) {
-    if (!(0, fs_1.existsSync)(file)) {
-        return { file, patched: false, replacements: 0 };
-    }
-    const before = (0, fs_1.readFileSync)(file, 'utf8');
-    let count = 0;
-    const after = before.replace(/^(\s*)port:\s*3000\s*,$/gm, (_match, indent) => {
-        count++;
-        return `${indent}port: Number(process.env.PORT) || 3000,`;
-    });
-    if (count === 0) {
-        return { file, patched: false, replacements: 0 };
-    }
-    (0, fs_1.writeFileSync)(file, after, 'utf8');
-    return { file, patched: true, replacements: count };
-}
-/**
- * Inject a "Local Development (Parallel Projects)" block with the
- * project's concrete ports into CLAUDE.md. Idempotent — re-running
- * with the same ports is a no-op; re-running with different ports
- * updates the block in place.
- *
- * The block is delimited by HTML comments so it can be located and
- * replaced reliably.
- */
-function patchClaudeMd(file, options) {
-    const { apiPort, appPort, dbName, slug } = options;
-    const startMarker = '<!-- lt-local:port-block:start -->';
-    const endMarker = '<!-- lt-local:port-block:end -->';
-    const dbLine = dbName ? `- DB:  \`mongodb://127.0.0.1/${dbName}\`\n` : '';
-    const block = [
-        startMarker,
-        '## Local Development (lt local)',
-        '',
-        `This project is registered with \`lt local\` (slug: \`${slug}\`). Use these commands to run alongside other lt-projects without port collisions:`,
-        '',
-        '```bash',
-        'lt local up        # Start API + App with project-specific ports',
-        'lt local down      # Stop the detached processes',
-        'lt local status    # Show running PIDs + bound ports',
-        'lt ports           # Inspect all reserved + bound dev ports',
-        '```',
-        '',
-        '**Active ports for THIS project:**',
-        '',
-        `- API: \`http://localhost:${apiPort}\``,
-        `- App: \`http://localhost:${appPort}\``,
-        dbLine,
-        'Env vars (set automatically by `lt local up`): `PORT`, `BASE_URL`, `APP_URL`, `NUXT_API_URL`, `NUXT_PUBLIC_API_URL`, `NUXT_PUBLIC_SITE_URL`, `NUXT_PUBLIC_STORAGE_PREFIX`, `NSC__MONGOOSE__URI`. **Never assume ports 3000/3001 for this project** — they may belong to a parallel project.',
-        '',
-        endMarker,
-    ]
-        .filter((line) => line !== null && line !== undefined)
-        .join('\n');
-    let content = '';
-    if ((0, fs_1.existsSync)(file)) {
-        content = (0, fs_1.readFileSync)(file, 'utf8');
-    }
-    else {
-        // Don't create CLAUDE.md from scratch — only patch if it exists.
-        return { file, patched: false, replacements: 0 };
-    }
-    const startIdx = content.indexOf(startMarker);
-    const endIdx = content.indexOf(endMarker);
-    let next;
-    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
-        // Replace existing block in place — the block does not include
-        // surrounding whitespace, so we slice exactly from start to end-of-marker.
-        const before = content.slice(0, startIdx);
-        const after = content.slice(endIdx + endMarker.length);
-        next = before + block + after;
-    }
-    else {
-        // Append at the end with one blank line separator + trailing newline
-        const sep = content.endsWith('\n\n') ? '' : content.endsWith('\n') ? '\n' : '\n\n';
-        next = `${content}${sep}${block}\n`;
-    }
-    // Idempotent check: if nothing changed, don't write
-    if (next === content) {
-        return { file, patched: false, replacements: 0 };
-    }
-    (0, fs_1.writeFileSync)(file, next, 'utf8');
-    return { file, patched: true, replacements: 1 };
-}
-/**
- * Patch nuxt-base-template-style `nuxt.config.ts`:
- * - `port: 3001,` → `port: Number(process.env.PORT) || 3001,`
- * - `target: 'http://localhost:3000'` → `target: process.env.NUXT_API_URL || 'http://localhost:3000'`
- *
- * Missing files are a no-op (matches `patchClaudeMd` behavior).
- */
-function patchNuxtConfig(file) {
-    if (!(0, fs_1.existsSync)(file)) {
-        return { file, patched: false, replacements: 0 };
-    }
-    const before = (0, fs_1.readFileSync)(file, 'utf8');
-    let count = 0;
-    let after = before.replace(/^(\s*)port:\s*3001\s*,$/gm, (_match, indent) => {
-        count++;
-        return `${indent}port: Number(process.env.PORT) || 3001,`;
-    });
-    after = after.replace(/target:\s*'http:\/\/localhost:3000'/g, () => {
-        count++;
-        return `target: process.env.NUXT_API_URL || 'http://localhost:3000'`;
-    });
-    if (count === 0) {
-        return { file, patched: false, replacements: 0 };
-    }
-    (0, fs_1.writeFileSync)(file, after, 'utf8');
-    return { file, patched: true, replacements: count };
-}
-/**
- * Patch nuxt-base-template-style `playwright.config.ts`:
- * - `baseURL: 'http://localhost:3001'` → uses NUXT_PUBLIC_SITE_URL
- * - `host: 'http://localhost:3001'`    → uses NUXT_PUBLIC_SITE_URL
- * - `url: 'http://localhost:3001'`     → uses NUXT_PUBLIC_SITE_URL
- *
- * Missing files are a no-op (matches `patchClaudeMd` behavior).
- */
-function patchPlaywrightConfig(file) {
-    if (!(0, fs_1.existsSync)(file)) {
-        return { file, patched: false, replacements: 0 };
-    }
-    const before = (0, fs_1.readFileSync)(file, 'utf8');
-    let count = 0;
-    let after = before.replace(/baseURL:\s*'http:\/\/localhost:3001'/g, () => {
-        count++;
-        return `baseURL: process.env.NUXT_PUBLIC_SITE_URL || 'http://localhost:3001'`;
-    });
-    after = after.replace(/host:\s*'http:\/\/localhost:3001'/g, () => {
-        count++;
-        return `host: process.env.NUXT_PUBLIC_SITE_URL || 'http://localhost:3001'`;
-    });
-    after = after.replace(/url:\s*'http:\/\/localhost:3001'/g, () => {
-        count++;
-        return `url: process.env.NUXT_PUBLIC_SITE_URL || 'http://localhost:3001'`;
-    });
-    if (count === 0) {
-        return { file, patched: false, replacements: 0 };
-    }
-    (0, fs_1.writeFileSync)(file, after, 'utf8');
-    return { file, patched: true, replacements: count };
-}

package/build/lib/port-registry.js

@@ -1,304 +0,0 @@
-"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 });
-exports.SLOT_PORT_RANGE_END = exports.SLOT_MAX = exports.SLOT_STEP = exports.SLOT_BASE_API = void 0;
-exports.allocatedSlots = allocatedSlots;
-exports.allocateSlot = allocateSlot;
-exports.checkPortInUse = checkPortInUse;
-exports.clearLocalState = clearLocalState;
-exports.isPidAlive = isPidAlive;
-exports.isValidPid = isValidPid;
-exports.listenSnapshot = listenSnapshot;
-exports.loadLocalState = loadLocalState;
-exports.loadRegistry = loadRegistry;
-exports.localStatePath = localStatePath;
-exports.portsForSlot = portsForSlot;
-exports.projectSlug = projectSlug;
-exports.registryPath = registryPath;
-exports.saveLocalState = saveLocalState;
-exports.saveRegistry = saveRegistry;
-exports.slotFromSlug = slotFromSlug;
-/**
- * Port registry helpers for `lt local` and `lt ports`.
- *
- * Provides:
- * - Deterministic slot allocation from a project slug (hash-based, reproducible across machines)
- * - Persistent registry at ~/.lenneTech/ports.json
- * - Live port introspection via `lsof` (single-call snapshot for batch checks)
- * - Process state tracking under <project>/.lt-local/state.json
- */
-const child_process_1 = require("child_process");
-const fs_1 = require("fs");
-const os_1 = require("os");
-const path_1 = require("path");
-/** Lowest API port: slot 0 maps to 3000/3001, slot 1 to 3010/3011, … */
-exports.SLOT_BASE_API = 3000;
-/** Distance between two adjacent slots' API ports. */
-exports.SLOT_STEP = 10;
-/** Number of slots [0..SLOT_MAX). API range = [SLOT_BASE_API, SLOT_BASE_API + SLOT_MAX*SLOT_STEP). */
-exports.SLOT_MAX = 90;
-/** Highest port (exclusive) covered by the slot range. Useful for live-port sweeps. */
-exports.SLOT_PORT_RANGE_END = exports.SLOT_BASE_API + exports.SLOT_MAX * exports.SLOT_STEP;
-/** All currently allocated slots in the registry. */
-function allocatedSlots(registry) {
-    return new Set(Object.values(registry.projects).map((p) => p.slot));
-}
-/**
- * Allocate a slot for a project. Returns deterministic slot from slug if free,
- * otherwise scans linearly until a free slot is found. Throws if all are taken.
- *
- * The linear scan loops `i in [1, SLOT_MAX)` (not `<=`) because `i = 0` is the
- * preferred slot already checked in the fast path above.
- */
-function allocateSlot(slug, registry) {
-    const taken = allocatedSlots(registry);
-    const preferred = slotFromSlug(slug);
-    if (!taken.has(preferred)) {
-        return preferred;
-    }
-    for (let i = 1; i < exports.SLOT_MAX; i++) {
-        const candidate = (preferred + i) % exports.SLOT_MAX;
-        if (!taken.has(candidate)) {
-            return candidate;
-        }
-    }
-    throw new Error('No free port slot available (all 90 slots are taken).');
-}
-/**
- * Check via `lsof` whether a single TCP port is currently bound by a LISTEN socket.
- *
- * For multi-port checks prefer {@link listenSnapshot} — it issues a single `lsof`
- * call instead of one per port (~50ms vs ~50ms × N).
- *
- * Note: `-iTCP:<port>` selects connections by *service port* — both LISTEN
- * sockets and remote endpoints. We filter explicitly to LISTEN via
- * `-sTCP:LISTEN` AND post-filter the NAME column for `*:<port>` /
- * `<addr>:<port>` (LISTEN) so outgoing connections whose remote port is
- * `<port>` don't trigger a false positive.
- *
- * Returns null if lsof is unavailable.
- */
-function checkPortInUse(port) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve) => {
-            var _a;
-            const child = (0, child_process_1.spawn)('lsof', ['-iTCP', `-sTCP:LISTEN`, '-nP', `-iTCP:${port}`], {
-                stdio: ['ignore', 'pipe', 'ignore'],
-            });
-            let out = '';
-            (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (chunk) => (out += chunk.toString()));
-            child.on('error', () => resolve(null));
-            child.on('close', () => {
-                const lines = out.trim().split('\n').slice(1); // skip header
-                const portRe = new RegExp(`:${port}\\s+\\(LISTEN\\)\\s*$`);
-                const match = lines.find((l) => portRe.test(l));
-                if (!match) {
-                    resolve({ inUse: false });
-                    return;
-                }
-                const cols = match.split(/\s+/);
-                resolve({ command: cols[0], inUse: true, pid: Number(cols[1]) });
-            });
-        });
-    });
-}
-/** Reset state file to an empty record. Called by `lt local down` after stopping processes. */
-function clearLocalState(projectPath) {
-    const path = localStatePath(projectPath);
-    if ((0, fs_1.existsSync)(path)) {
-        (0, fs_1.writeFileSync)(path, `${JSON.stringify({ pids: {}, ports: { api: 0, app: 0 }, startedAt: '' }, null, 2)}\n`, 'utf8');
-    }
-}
-/**
- * Check whether a PID is still alive without sending any signal.
- * `process.kill(pid, 0)` performs a permission check; ESRCH means dead.
- *
- * Refuses non-positive / non-integer PIDs to prevent accidental probes
- * of process groups (negative PID) or every user-owned process (PID 0/-1).
- */
-function isPidAlive(pid) {
-    if (!Number.isInteger(pid) || pid <= 0)
-        return false;
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (e) {
-        return e.code === 'EPERM';
-    }
-}
-/**
- * Validate a value parsed from `state.json` as a plausible PID.
- *
- * Accepts: positive integer in [100, 2^31 - 1] or undefined.
- * The lower bound 100 excludes init / kernel / login PIDs that should
- * never be the result of a `pnpm start` spawn.
- */
-function isValidPid(value) {
-    if (value === undefined)
-        return true;
-    if (typeof value !== 'number')
-        return false;
-    return Number.isInteger(value) && value >= 100 && value <= 0x7fffffff;
-}
-/**
- * One-shot listener snapshot for an arbitrary set of ports.
- *
- * Issues a single `lsof -iTCP -sTCP:LISTEN -nP` call and filters in memory.
- * ~50ms total regardless of port count, vs ~50ms × N for sequential
- * {@link checkPortInUse} calls.
- *
- * Returns an empty Map if `lsof` is unavailable.
- */
-function listenSnapshot(ports) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve) => {
-            var _a;
-            const child = (0, child_process_1.spawn)('lsof', ['-iTCP', '-sTCP:LISTEN', '-nP'], { stdio: ['ignore', 'pipe', 'ignore'] });
-            let out = '';
-            (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (chunk) => (out += chunk.toString()));
-            child.on('error', () => resolve(new Map()));
-            child.on('close', () => {
-                const wanted = new Set(ports);
-                const result = new Map();
-                const lines = out.trim().split('\n').slice(1);
-                const re = /:(\d+)\s+\(LISTEN\)\s*$/;
-                for (const line of lines) {
-                    const m = re.exec(line);
-                    if (!m)
-                        continue;
-                    const port = Number(m[1]);
-                    if (!wanted.has(port))
-                        continue;
-                    if (result.has(port))
-                        continue; // first hit wins (IPv4 before IPv6)
-                    const cols = line.split(/\s+/);
-                    result.set(port, { command: cols[0], pid: Number(cols[1]) });
-                }
-                resolve(result);
-            });
-        });
-    });
-}
-/**
- * Load the local state JSON for a project.
- *
- * Returns null when the file is missing, unreadable, malformed, or contains
- * structurally invalid data (see {@link isValidPid}). The schema validation
- * here is the authoritative gate: it prevents `process.kill(-pid, …)` in
- * `lt local down` from receiving anything but a plausible PID we ourselves
- * could have written.
- */
-function loadLocalState(projectPath) {
-    const path = localStatePath(projectPath);
-    if (!(0, fs_1.existsSync)(path))
-        return null;
-    try {
-        const parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
-        if (!parsed || typeof parsed !== 'object')
-            return null;
-        const obj = parsed;
-        const pids = obj.pids;
-        const ports = obj.ports;
-        if (!pids || typeof pids !== 'object' || !ports || typeof ports !== 'object')
-            return null;
-        if (!isValidPid(pids.api) || !isValidPid(pids.app))
-            return null;
-        if (typeof ports.api !== 'number' || typeof ports.app !== 'number')
-            return null;
-        if (typeof obj.startedAt !== 'string')
-            return null;
-        return {
-            pids: { api: pids.api, app: pids.app },
-            ports: { api: ports.api, app: ports.app },
-            startedAt: obj.startedAt,
-        };
-    }
-    catch (_a) {
-        return null;
-    }
-}
-/**
- * Load registry; returns empty if missing or corrupt.
- *
- * Prints a warning when a corrupt or schema-incompatible file is encountered
- * so the user notices the silent reset rather than discovering stale port
- * allocations later.
- */
-function loadRegistry() {
-    const path = registryPath();
-    if (!(0, fs_1.existsSync)(path)) {
-        return { projects: {}, version: 1 };
-    }
-    try {
-        const raw = (0, fs_1.readFileSync)(path, 'utf8');
-        const parsed = JSON.parse(raw);
-        if ((parsed === null || parsed === void 0 ? void 0 : parsed.version) !== 1 || typeof (parsed === null || parsed === void 0 ? void 0 : parsed.projects) !== 'object') {
-            console.warn(`[lt] ports.json has wrong schema (got version=${parsed === null || parsed === void 0 ? void 0 : parsed.version}); starting with empty registry.`);
-            return { projects: {}, version: 1 };
-        }
-        return parsed;
-    }
-    catch (e) {
-        console.warn(`[lt] ports.json was unreadable (${e.message}); starting with empty registry.`);
-        return { projects: {}, version: 1 };
-    }
-}
-/** Path to the local state file inside a project. */
-function localStatePath(projectPath) {
-    return (0, path_1.join)(projectPath, '.lt-local', 'state.json');
-}
-/** Convert a slot to its API+App port pair. */
-function portsForSlot(slot) {
-    const api = exports.SLOT_BASE_API + slot * exports.SLOT_STEP;
-    return { api, app: api + 1 };
-}
-/** Convert any project path → a stable slug (basename, lowercase, alpha-num + dashes). */
-function projectSlug(projectPath) {
-    const base = projectPath.replace(/\/+$/, '').split('/').pop() || 'project';
-    return base
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-}
-/**
- * Path to the central registry.
- *
- * Honors `LT_PORTS_REGISTRY_PATH` for tests / non-default workspaces;
- * falls back to `~/.lenneTech/ports.json`.
- */
-function registryPath() {
-    return process.env.LT_PORTS_REGISTRY_PATH || (0, path_1.join)((0, os_1.homedir)(), '.lenneTech', 'ports.json');
-}
-/** Persist local state to <project>/.lt-local/state.json (creates the parent directory if needed). */
-function saveLocalState(projectPath, state) {
-    const path = localStatePath(projectPath);
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
-    (0, fs_1.writeFileSync)(path, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
-}
-/** Save registry, creating parent directory if needed. */
-function saveRegistry(registry) {
-    const path = registryPath();
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
-    (0, fs_1.writeFileSync)(path, `${JSON.stringify(registry, null, 2)}\n`, 'utf8');
-}
-/**
- * Deterministic slot from project slug — same slug yields the same slot on every machine.
- * Uses the lower 32 bits of FNV-1a then modulo SLOT_MAX.
- */
-function slotFromSlug(slug) {
-    let hash = 2166136261; // FNV-1a 32-bit offset basis
-    for (let i = 0; i < slug.length; i++) {
-        hash ^= slug.charCodeAt(i);
-        hash = Math.imul(hash, 16777619);
-    }
-    return Math.abs(hash | 0) % exports.SLOT_MAX;
-}