@lenne.tech/cli 1.21.0 → 1.22.0

package/docs/commands.md

@@ -286,188 +286,201 @@ For mode-aware update workflows after conversion, use:
 
 ## Local Development Commands
 
-Orchestrate parallel lt projects on the same machine without port collisions. Each project gets a deterministic port slot derived from its slug; API/App ports are always slot-paired (`3000+slot*10` / `3001+slot*10`). Slot allocation is reproducible across machines (FNV-1a hash) and persisted in `~/.lenneTech/ports.json`.
+Run multiple lt projects in parallel without port collisions or cross-wiring.
+**URL-first**: every project gets stable HTTPS URLs (`<slug>.localhost`,
+`api.<slug>.localhost`) served by Caddy. Internal ports are opaque and
+auto-allocated. Cross-project state (database, storage, cookies) is
+namespaced by slug so projects cannot accidentally interfere.
 
-### `lt local`
+### `lt dev`
 
 Open the local-orchestration submenu.
 
 **Usage:**
 ```bash
-lt local
+lt dev
 ```
 
-**Alias:** `lt l`
+**Alias:** `lt d`
 
 ---
 
-### `lt local init`
+### `lt dev install`
 
-Register the current project in the central port registry, optionally patching legacy hardcoded ports to be env-aware.
+One-time per-machine setup. Idempotent — re-run anytime to diagnose what's missing.
 
 **Usage:**
 ```bash
-lt local init [options]
+lt dev install
 ```
 
-**Alias:** `lt l i`
-
-**Options:**
-| Option | Description |
-|--------|-------------|
-| `--slot <n>` | Force a specific slot index (0..89) instead of the deterministic slug hash |
-| `--patch` | Apply env-aware port patches non-interactively |
-| `--no-patch` | Skip the patch detection / prompt entirely |
-| `--noConfirm` | Skip confirmation prompts (without `--patch`, patches are skipped) |
+**Alias:** `lt d i`
 
 **What it does:**
-1. Detects the workspace layout (monorepo with `projects/api/` + `projects/app/`, or standalone API/App project).
-2. Looks up or allocates a slot via FNV-1a hash of the project slug. If the slot is taken, falls through linearly to the next free slot.
-3. Detects legacy hardcoded ports in `config.env.ts` (`port: 3000`), `nuxt.config.ts` (`port: 3001`, vite proxy `target: 'http://localhost:3000'`), and `playwright.config.ts` (`baseURL`/`host`/`url: 'http://localhost:3001'`). If `--patch` (or interactive confirm), rewrites them to env-overridable form (`Number(process.env.PORT) || 3000`, `process.env.NUXT_API_URL || …`, etc.) — defaults preserved, idempotent.
-4. Persists the entry to `~/.lenneTech/ports.json`.
-5. Adds `.lt-local/` to the project's `.gitignore`.
-6. Injects (or refreshes) a "Local Development (lt local)" port block into `CLAUDE.md` files at the workspace root and inside each subproject — bracketed by HTML comment markers so it can be replaced cleanly when ports change.
+1. Verifies `caddy` is on PATH (suggests `brew install caddy` if missing).
+2. Creates `~/.lenneTech/Caddyfile` stub if absent.
+3. Verifies the Caddy daemon is running (suggests `brew services start caddy`).
+4. Validates the Caddyfile.
+5. Reminds you to run `sudo caddy trust` once so browsers accept `https://*.localhost`.
 
-**Examples:**
-```bash
-# Inside a workspace or standalone project
-lt local init
+---
 
-# Force slot 5 for predictable cross-team ports
-lt local init --slot 5 --noConfirm --patch
+### `lt dev migrate`
 
-# Register without touching any source files
-lt local init --no-patch --noConfirm
+Register an existing project with `lt dev` and apply idempotent env-aware patches. Safe to run multiple times; safe to run after `lt fullstack init`.
+
+**Usage:**
+```bash
+lt dev migrate
 ```
 
+**Alias:** `lt d m`
+
+**What it does:**
+1. Detects the workspace layout (monorepo `projects/api`+`projects/app`, or standalone).
+2. Builds the project identity (slug from `package.json` "name", subdomains).
+3. Patches legacy hardcoded ports in `config.env.ts` (`port: 3000`), `nuxt.config.ts` (`port: 3001`, vite proxy target), `playwright.config.ts` (`baseURL`/`host`/`url`) to env-overridable form. Defaults preserved, idempotent.
+4. Persists the entry to `~/.lenneTech/projects.json` (override path via `LT_DEV_REGISTRY_PATH`).
+5. Adds `.lt-dev/` to the project's `.gitignore`.
+6. Injects (or refreshes) a "Local Development (lt dev)" URL block into `CLAUDE.md` files at the workspace root and inside each subproject — bracketed by HTML comment markers.
+
 ---
 
-### `lt local up`
+### `lt dev up`
 
-Start the API + App with project-specific ports. Spawns `pnpm start` (api) and `pnpm dev` (app) detached; persists PIDs to `<root>/.lt-local/state.json`.
+Start API + App behind Caddy. Allocates internal ports (4000+), spawns processes detached, persists PIDs to `<root>/.lt-dev/state.json`.
 
 **Usage:**
 ```bash
-lt local up
+lt dev up
 ```
 
-**Alias:** `lt l u`
+**Alias:** `lt d u`
 
-**Environment variables injected into both children:**
+**Environment variables injected:**
 | Variable | Consumer | Example value |
 |----------|----------|---------------|
-| `PORT` | Nest (api) / Nuxt dev server (app) | slot-derived |
-| `BASE_URL` | nest-server config.env.ts (canonical API base) | `http://localhost:3030` |
-| `APP_URL` | nest-server config.env.ts (frontend origin for redirects/CORS) | `http://localhost:3031` |
-| `NUXT_API_URL` | Nuxt vite-proxy target for `/api`, `/iam`, … | `http://localhost:3030` |
-| `NUXT_PUBLIC_API_URL` | Nuxt `useRuntimeConfig().public.apiUrl` | `http://localhost:3030` |
-| `NUXT_PUBLIC_SITE_URL` | Nuxt `useRuntimeConfig().public.siteUrl` + Playwright | `http://localhost:3031` |
-| `NUXT_PUBLIC_STORAGE_PREFIX` | namespaces sessionStorage/localStorage so parallel projects don't share auth tokens | `crm-local` |
-| `NSC__MONGOOSE__URI` | nest-server-config Mongoose URI (only when `dbName` is known) | `mongodb://127.0.0.1/crm-local` |
-
-**Override the binary** used for both spawns by setting `LT_PNPM_BIN` (e.g. `LT_PNPM_BIN=/usr/local/bin/pnpm lt local up`).
+| `PORT` | Nest (api) / Nuxt (app) | auto-allocated 4000+ |
+| `BASE_URL` / `NSC__BASE_URL` | nest-server canonical API URL | `https://api.crm.localhost` |
+| `APP_URL` / `NSC__APP_URL` | nest-server frontend origin (CORS, BetterAuth) | `https://crm.localhost` |
+| `NUXT_API_URL` | Nuxt vite-proxy target for `/api`, `/iam`, … | `https://api.crm.localhost` |
+| `NUXT_PUBLIC_API_URL` | Nuxt `useRuntimeConfig().public.apiUrl` | `https://api.crm.localhost` |
+| `NUXT_PUBLIC_SITE_URL` | Nuxt `useRuntimeConfig().public.siteUrl` + Playwright | `https://crm.localhost` |
+| `NUXT_PUBLIC_STORAGE_PREFIX` | namespaces sessionStorage/localStorage | `crm` |
+| `NUXT_PUBLIC_API_PROXY` | always `false` — Caddy + cookie-domain make it obsolete | `false` |
+| `NSC__MONGOOSE__URI` | nest-server Mongoose URI | `mongodb://127.0.0.1/crm-local` |
+| `DATABASE_URL` | Postgres convenience URL (for nest-base-style projects) | `postgresql://crm-local:crm-local@localhost:5432/crm-local` |
+
+**Override the binary** for both spawns via `LT_PNPM_BIN` (e.g. `LT_PNPM_BIN=/usr/local/bin/pnpm lt dev up`).
 
 **Pre-flight guards (exit code 1 each):**
-- Project not registered (`lt local init` first)
-- Already running (run `lt local down` first)
-- Port already in use by another process
+- Caddy not installed (`lt dev install` first)
+- Caddy daemon not running (`brew services start caddy`)
+- Already running for this project (`lt dev down` first)
+- Internal port already in use
 
-**Logs:** `<root>/.lt-local/api.log`, `<root>/.lt-local/app.log` (append-mode).
+**Logs:** `<root>/.lt-dev/api.log`, `<root>/.lt-dev/app.log` (append-mode).
 
 ---
 
-### `lt local down`
+### `lt dev down`
 
-Stop processes started by `lt local up`. Sends `SIGTERM` to the detached process group (negative PID) so descendants — Vite, the Nest watcher, etc. — receive the signal too. Falls back to single-PID kill if the process group send fails (`EPERM`).
+Stop processes started by `lt dev up` and remove the project's Caddy block.
 
 **Usage:**
 ```bash
-lt local down
+lt dev down
 ```
 
-**Alias:** `lt l d`
+**Alias:** `lt d d`
 
-PID values from `state.json` are validated (positive integer in `[100, 2^31)`) before any signal is sent, so a tampered state file cannot cause `lt local down` to signal arbitrary process groups.
+Sends `SIGTERM` to the detached process group (negative PID) so descendants — Vite, the Nest watcher, etc. — receive the signal too. PID values from `state.json` are validated before signaling. Best-effort: removes the project's Caddy block and reloads even if no session was active.
 
 ---
 
-### `lt local status`
+### `lt dev status`
 
-Show what is registered + running for the current project: slot, ports, db URI, PIDs (alive/dead), and live `lsof` state of the assigned ports.
+Show what is registered + running.
 
 **Usage:**
 ```bash
-lt local status
+lt dev status         # current project
+lt dev status --all   # every project in the registry
 ```
 
-**Alias:** `lt l s`
-
----
+**Alias:** `lt d s`
 
-## Ports Commands
+The current-project view shows subdomains → upstream ports, db URI, session PIDs (alive/dead), and live `lsof` state. The `--all` view lists every project, with a `●`/`○` indicator for running state.
 
-Inspect the port registry and currently-bound dev ports across all your lt projects. Useful for diagnosing collisions and rebuilding the registry from disk.
+---
 
-### `lt ports`
+### `lt dev doctor`
 
-List all reserved registry entries side-by-side with the live `lsof` state. Issues a single `lsof` call internally for the entire slot range (3000–3899) instead of per port — runs in ~150ms regardless of how many projects are registered.
+Diagnose Caddy / CA / DNS / port issues. Exit code 0 = all green, 1 = at least one FAIL.
 
 **Usage:**
 ```bash
-lt ports
+lt dev doctor
 ```
 
-**Alias:** `lt p`
+**Alias:** `lt d doc`
 
-**Output sections:**
-1. **Reserved ports (registry)** — every project entry with a `●` (bound) or `○` (free) indicator per port.
-2. **Currently bound dev ports (3000–3899)** — every port in the slot range that currently has a LISTEN socket, with command + PID + owning registry entry (if any).
+**Checks:**
+1. `caddy` on PATH
+2. Caddy daemon running (admin endpoint `:2019` reachable)
+3. Caddyfile validates
+4. Ports 80 + 443 free or held by Caddy
+5. `*.localhost` resolves to `127.0.0.1` (RFC 6761)
+6. Registry status
 
 ---
 
-### `lt ports check <port>`
+### `lt dev test`
 
-Exit-coded port probe — useful in shell scripts.
+One-shot E2E wrapper: ensure `up`, wait for the App URL, run `pnpm run test:e2e` with the `.lt-dev/.env` bridge loaded. Optional teardown after.
 
 **Usage:**
 ```bash
-lt ports check <port>
+lt dev test                      # App E2E (projects/app)
+lt dev test --api                # API E2E (projects/api) — no Caddy required
+lt dev test --teardown           # plus `lt dev down` after
+lt dev test --debug              # PWDEBUG=1 + HEADED=1
+lt dev test -- --ui spec.ts      # everything after `--` is forwarded to playwright
 ```
 
-**Exit codes:**
-| Code | Meaning |
-|------|---------|
-| `0` | Port is free |
-| `1` | Port is in use |
-| `2` | `lsof` not available, or `<port>` argument missing/invalid |
+**Alias:** `lt d t`
 
-**Example:**
-```bash
-if lt ports check 3000; then
-  echo "API port free"
-else
-  echo "API port already bound"
-fi
-```
+**Behaviour:**
+1. Pre-flight: Caddy installed + daemon running (App mode only).
+2. If no `lt dev up` session is alive: invokes `lt dev up` first.
+3. Waits up to 30 s for the App URL to respond.
+4. Reads `<root>/.lt-dev/.env` and merges into the spawn env (existing process.env wins for keys it defines).
+5. Spawns `pnpm run test:e2e [forwarded args]` in `projects/api` (with `--api`) or `projects/app` (default).
+6. With `--teardown`, runs `lt dev down` after.
+
+**When to use this vs. `pnpm run test:e2e` directly:**
+- Use **`lt dev test`** for TDD loops, ad-hoc reproduction, or when you want a single-command "ensure-up + run + teardown" flow.
+- Use **direct `pnpm run test:e2e`** (or VS Code Playwright Extension, IDE test runners) for everyday work — the auto-injected `playwright.config.ts` bridge loads the `.lt-dev/.env` automatically, so the env is correct without the wrapper.
 
 ---
 
-### `lt ports scan [dir]`
+### ENV bridge for external test runners
 
-Rebuild the registry from the filesystem. Walks the given directory (default: cwd) up to depth 3, looking for `lt.config.json` + `package.json` pairs or workspace markers (`pnpm-workspace.yaml`, `projects/`). Re-allocates a slot for new projects; preserves slots for existing entries (only refreshing the path if it moved). Writes only when the registry actually changed (no mtime churn for cloud-sync tools).
+`lt dev up` writes a `<root>/.lt-dev/.env` file with the following keys:
 
-**Usage:**
-```bash
-lt ports scan [dir]
-```
+| Key | Source |
+|-----|--------|
+| `BASE_URL`, `APP_URL`, `NSC__BASE_URL`, `NSC__APP_URL` | Identity → `https://api.<slug>.localhost` / `https://<slug>.localhost` |
+| `NUXT_API_URL`, `NUXT_PUBLIC_API_URL`, `NUXT_PUBLIC_SITE_URL` | Same URLs for Nuxt |
+| `NUXT_PUBLIC_STORAGE_PREFIX` | Project slug |
+| `NUXT_PUBLIC_API_PROXY` | Always `false` under `lt dev` |
+| `NSC__MONGOOSE__URI`, `DATABASE_URL` | Project-namespaced DB URI (when `dbName` known) |
+| `LT_DEV_ACTIVE`, `LT_DEV_DB_NAME` | Marker keys for consumers |
+| `NODE_EXTRA_CA_CERTS` | Path to Caddy's root CA cert (auto-detected) |
 
-**Examples:**
-```bash
-lt ports scan                       # scan from cwd
-lt ports scan ~/code/lenneTech      # scan a specific tree
-```
+`lt dev migrate` injects a tiny `// >>> lt-dev:bridge >>>` block at the top of `playwright.config.ts` that loads this file at config-load time — making Playwright (CLI, IDE, VS Code extension) automatically use the `lt dev` URLs and trust the local CA, without inheriting the parent shell.
 
-Symlinks are skipped to avoid traversal loops; dotdirs and `node_modules` are not descended into.
+`lt dev down` removes the bridge file so subsequent runs without `lt dev up` fall back cleanly to the classic `localhost:3000`/`localhost:3001` defaults.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/cli",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",

package/build/commands/local/down.js

@@ -1,71 +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 });
-const local_project_1 = require("../../lib/local-project");
-const port_registry_1 = require("../../lib/port-registry");
-/**
- * Stop processes started by `lt local up`. Sends SIGTERM to the
- * detached process group (negative PID) so descendants — Vite,
- * the Nest watcher etc. — receive the signal too.
- */
-const DownCommand = {
-    alias: ['d'],
-    description: 'Stop API + App',
-    hidden: false,
-    name: 'down',
-    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        const { filesystem, parameters, print: { colors, info, success, warning }, } = toolbox;
-        const layout = (0, local_project_1.resolveLayout)(filesystem.cwd(), filesystem);
-        const state = (0, port_registry_1.loadLocalState)(layout.root);
-        if (!state || (!state.pids.api && !state.pids.app)) {
-            info(colors.dim('No running processes registered for this project.'));
-            if (!parameters.options.fromGluegunMenu)
-                process.exit();
-            return 'local down: nothing to stop';
-        }
-        const stopped = [];
-        for (const [name, pid] of Object.entries(state.pids)) {
-            if (!pid)
-                continue;
-            // Defense-in-depth: refuse anything that loadLocalState's schema gate
-            // wouldn't have accepted. Prevents a tampered state.json from causing
-            // process.kill(-pid, …) to signal arbitrary process groups.
-            if (!(0, port_registry_1.isValidPid)(pid)) {
-                warning(`Refusing to signal suspicious pid ${pid} for ${name} (state.json tampered?)`);
-                continue;
-            }
-            if (!(0, port_registry_1.isPidAlive)(pid)) {
-                stopped.push(`${name} (pid ${pid}, already dead)`);
-                continue;
-            }
-            try {
-                // Negative PID kills the process group of a detached process.
-                process.kill(-pid, 'SIGTERM');
-                stopped.push(`${name} (pid ${pid})`);
-            }
-            catch (_a) {
-                try {
-                    process.kill(pid, 'SIGTERM');
-                    stopped.push(`${name} (pid ${pid}, single)`);
-                }
-                catch (_b) {
-                    warning(`Failed to stop ${name} (pid ${pid})`);
-                }
-            }
-        }
-        (0, port_registry_1.clearLocalState)(layout.root);
-        success(`Stopped: ${stopped.join(', ')}`);
-        if (!parameters.options.fromGluegunMenu)
-            process.exit();
-        return `local down: ${stopped.length} stopped`;
-    }),
-};
-module.exports = DownCommand;

package/build/commands/local/init.js

@@ -1,162 +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 });
-const fs_1 = require("fs");
-const path_1 = require("path");
-const local_patches_1 = require("../../lib/local-patches");
-const local_project_1 = require("../../lib/local-project");
-const port_registry_1 = require("../../lib/port-registry");
-/**
- * Register a port slot for the current project + optionally patch
- * legacy hardcoded ports.
- */
-const InitCommand = {
-    alias: ['i'],
-    description: 'Register port slot',
-    hidden: false,
-    name: 'init',
-    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        const { filesystem, parameters, print: { colors, error, info, success, warning }, prompt, } = toolbox;
-        const layout = (0, local_project_1.resolveLayout)(filesystem.cwd(), filesystem);
-        if (!layout.apiDir && !layout.appDir) {
-            error('No API (src/config.env.ts) or App (nuxt.config.ts) project detected at this path.');
-            if (!parameters.options.fromGluegunMenu)
-                process.exit(1);
-            return 'local init: not a project';
-        }
-        const slug = (0, port_registry_1.projectSlug)(layout.root);
-        const registry = (0, port_registry_1.loadRegistry)();
-        // Determine slot: existing entry > CLI flag > deterministic from slug.
-        let slot;
-        const cliSlot = parameters.options.slot !== undefined ? Number(parameters.options.slot) : null;
-        if (registry.projects[slug]) {
-            slot = registry.projects[slug].slot;
-            info(`Project "${slug}" already registered with slot ${slot}.`);
-        }
-        else if (cliSlot !== null && Number.isFinite(cliSlot)) {
-            slot = cliSlot;
-        }
-        else {
-            slot = (0, port_registry_1.allocateSlot)(slug, registry);
-        }
-        const ports = (0, port_registry_1.portsForSlot)(slot);
-        info('');
-        info(colors.bold('Project layout'));
-        info(colors.dim('─'.repeat(50)));
-        info(`  name:  ${slug}`);
-        info(`  root:  ${layout.root}`);
-        if (layout.apiDir)
-            info(`  api:   ${layout.apiDir}`);
-        if (layout.appDir)
-            info(`  app:   ${layout.appDir}`);
-        info(`  slot:  ${slot}`);
-        info(`  ports: api=${ports.api}  app=${ports.app}`);
-        // Detect legacy hardcoded ports
-        const apiPatchFile = layout.apiDir ? (0, local_project_1.apiNeedsPortPatch)(layout.apiDir) : null;
-        const appPatchFiles = layout.appDir ? (0, local_project_1.appNeedsPortPatch)(layout.appDir) : [];
-        const filesToPatch = [apiPatchFile, ...appPatchFiles].filter((f) => Boolean(f));
-        const noConfirm = Boolean(parameters.options.noConfirm);
-        const noPatch = Boolean(parameters.options.noPatch);
-        const forcePatch = Boolean(parameters.options.patch);
-        if (filesToPatch.length > 0 && !noPatch) {
-            info('');
-            warning('Files with legacy hardcoded ports detected:');
-            filesToPatch.forEach((f) => info(`  - ${f}`));
-            info(colors.dim('Patch makes them env-overridable: `process.env.PORT || 3000` etc. — defaults preserved.'));
-            let doPatch = forcePatch;
-            if (!doPatch && !noConfirm) {
-                const ans = yield prompt.confirm('Apply env-aware patches now?', true);
-                doPatch = Boolean(ans);
-            }
-            else if (!doPatch && noConfirm) {
-                info(colors.dim('Skipping patches (--noConfirm without --patch). Pass --patch to auto-apply.'));
-            }
-            if (doPatch) {
-                for (const file of filesToPatch) {
-                    const result = (0, local_patches_1.autoPatch)(file);
-                    if (result.patched) {
-                        success(`patched ${result.replacements}× in ${file}`);
-                    }
-                    else {
-                        info(colors.dim(`skipped (already patched): ${file}`));
-                    }
-                }
-            }
-        }
-        else if (filesToPatch.length === 0) {
-            info(colors.dim('  patches: not needed (already env-aware)'));
-        }
-        // Persist to registry only when something actually changed — avoids
-        // mtime churn on ~/.lenneTech/ports.json for cloud-sync tools (Dropbox,
-        // iCloud Drive, Syncthing) and editor "file changed externally" prompts.
-        const dbName = deriveDbName(layout, slug);
-        const existing = registry.projects[slug];
-        const next = { dbName, path: layout.root, ports, slot };
-        const changed = !existing ||
-            existing.path !== next.path ||
-            existing.slot !== next.slot ||
-            existing.dbName !== next.dbName ||
-            existing.ports.api !== next.ports.api ||
-            existing.ports.app !== next.ports.app;
-        if (changed) {
-            registry.projects[slug] = next;
-            (0, port_registry_1.saveRegistry)(registry);
-        }
-        // Add .lt-local/ to .gitignore (idempotent)
-        addToGitignore(layout.root, '.lt-local/');
-        // Patch CLAUDE.md files (workspace + each subproject) with the active
-        // port block so future Claude Code sessions read the correct ports
-        // even when the lt-dev plugin's hook is not active.
-        const claudeMdCandidates = [
-            (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 claudePatches = claudeMdCandidates
-            .map((file) => (0, local_patches_1.patchClaudeMd)(file, { apiPort: ports.api, appPort: ports.app, dbName, slug }))
-            .filter((r) => r.patched);
-        if (claudePatches.length > 0) {
-            claudePatches.forEach((r) => success(`updated CLAUDE.md port block: ${r.file}`));
-        }
-        info('');
-        success(`Registered. Run \`lt local up\` to start.`);
-        if (!parameters.options.fromGluegunMenu)
-            process.exit();
-        return `local init ${slug} slot=${slot}`;
-    }),
-};
-/** Append entry to .gitignore if not already present. */
-function addToGitignore(root, entry) {
-    const path = (0, path_1.join)(root, '.gitignore');
-    let content = '';
-    if ((0, fs_1.existsSync)(path))
-        content = (0, fs_1.readFileSync)(path, 'utf8');
-    const lines = content.split(/\r?\n/);
-    if (lines.some((l) => l.trim() === entry || l.trim() === entry.replace(/\/$/, '')))
-        return;
-    const ensured = `${(content.endsWith('\n') || content.length === 0 ? content : `${content}\n`) + entry}\n`;
-    (0, fs_1.writeFileSync)(path, ensured, 'utf8');
-}
-/** Derive a sensible default DB name from project + workspace shape. */
-function deriveDbName(layout, slug) {
-    // Reuse existing dbName from the API config if it is the default `${slug}-local`
-    if (layout.apiDir) {
-        const cfg = (0, path_1.join)(layout.apiDir, 'src', 'config.env.ts');
-        if ((0, fs_1.existsSync)(cfg)) {
-            const content = (0, fs_1.readFileSync)(cfg, 'utf8');
-            const match = content.match(/dbName:\s*['"`]([^'"`]+)['"`]/);
-            if (match)
-                return match[1];
-        }
-    }
-    return `${slug}-local`;
-}
-module.exports = InitCommand;

package/build/commands/local/status.js

@@ -1,69 +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 });
-const local_project_1 = require("../../lib/local-project");
-const port_registry_1 = require("../../lib/port-registry");
-/**
- * Show what is running for the current project.
- */
-const StatusCommand = {
-    alias: ['s'],
-    description: 'Show local status',
-    hidden: false,
-    name: 'status',
-    run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
-        const { filesystem, parameters, print: { colors, info, warning }, } = toolbox;
-        const layout = (0, local_project_1.resolveLayout)(filesystem.cwd(), filesystem);
-        const slug = (0, port_registry_1.projectSlug)(layout.root);
-        const registry = (0, port_registry_1.loadRegistry)();
-        const entry = registry.projects[slug];
-        info('');
-        info(colors.bold(`Local status: ${slug}`));
-        info(colors.dim('─'.repeat(50)));
-        if (!entry) {
-            warning('Not registered. Run `lt local init` first.');
-            if (!parameters.options.fromGluegunMenu)
-                process.exit();
-            return 'local status: not registered';
-        }
-        const ports = (0, port_registry_1.portsForSlot)(entry.slot);
-        info(`  slot:  ${entry.slot}`);
-        info(`  api:   http://localhost:${ports.api}`);
-        info(`  app:   http://localhost:${ports.app}`);
-        if (entry.dbName)
-            info(`  db:    mongodb://127.0.0.1/${entry.dbName}`);
-        const state = (0, port_registry_1.loadLocalState)(layout.root);
-        info('');
-        if (!state || (!state.pids.api && !state.pids.app)) {
-            info(colors.dim('  no `lt local up` session active'));
-        }
-        else {
-            const apiAlive = state.pids.api ? (0, port_registry_1.isPidAlive)(state.pids.api) : false;
-            const appAlive = state.pids.app ? (0, port_registry_1.isPidAlive)(state.pids.app) : false;
-            info(`  api: ${apiAlive ? colors.green('running') : colors.red('dead')} (pid ${(_a = state.pids.api) !== null && _a !== void 0 ? _a : '-'})`);
-            info(`  app: ${appAlive ? colors.green('running') : colors.red('dead')} (pid ${(_b = state.pids.app) !== null && _b !== void 0 ? _b : '-'})`);
-            info(colors.dim(`  started: ${state.startedAt}`));
-        }
-        info('');
-        info(colors.bold('Live port state'));
-        const liveSnapshot = yield (0, port_registry_1.listenSnapshot)([ports.api, ports.app]);
-        for (const port of [ports.api, ports.app]) {
-            const r = liveSnapshot.get(port);
-            info(`  ${port}: ${r ? colors.green(`bound to ${r.command} (pid ${r.pid})`) : colors.dim('free')}`);
-        }
-        info('');
-        if (!parameters.options.fromGluegunMenu)
-            process.exit();
-        return `local status ${slug}`;
-    }),
-};
-module.exports = StatusCommand;