@lenne.tech/cli 1.50.2 → 1.50.3

package/build/commands/dev/up.js

@@ -252,22 +252,19 @@ const UpCommand = {
                 process.exit(1);
             return 'dev up: port in use';
         }
-        // The CLAUDE.md URL block is written HERE, after the internal ports are
-        // resolved, so it can name both addresses: the `*.localhost` name a browser
-        // opens and the loopback address a script must use. It used to run before
-        // allocation, where only the name existed — which is why an agent following
-        // the block had nothing but a hostname that does not resolve for Node on
-        // Windows. NEVER for a ticket worktree: that CLAUDE.md is git-tracked and
-        // would carry per-ticket URLs into a commit.
+        // The CLAUDE.md URL block names both addresses: the `*.localhost` name a
+        // browser opens and, for a script, the env var that carries the loopback
+        // address. Not the port itself: the base CLAUDE.md is git-tracked too, and the
+        // port differs per machine, so writing it here dirtied every checkout on each
+        // `lt dev up` (see `patchClaudeMd`). NEVER for a ticket worktree: that
+        // CLAUDE.md would carry per-ticket URLs into a commit.
         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, { apiPort, appPort, dbName, identity }))
-                .filter((r) => r.patched);
+            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)`));
             }

package/build/lib/dev-patches.js

@@ -125,7 +125,7 @@ function patchApiConfig(file) {
  * in place.
  */
 function patchClaudeMd(file, options) {
-    const { apiPort, appPort, dbName, identity } = options;
+    const { dbName, identity } = options;
     const startMarker = '<!-- lt-dev:url-block:start -->';
     const endMarker = '<!-- lt-dev:url-block:end -->';
     const apiSub = identity.subdomains.api;
@@ -155,14 +155,22 @@ function patchClaudeMd(file, options) {
     // agent following it would `curl` a name that does not resolve for Node on
     // Windows, and fail silently. The browser address stays first: it is the one a
     // human opens.
-    if (appSub) {
-        lines.push(`- App: \`https://${appSub.hostname}\`${appPort ? ` — from a script: \`http://127.0.0.1:${appPort}\`` : ''}`);
-    }
-    if (apiSub) {
-        lines.push(`- API: \`https://${apiSub.hostname}\`${apiPort ? ` — from a script: \`http://127.0.0.1:${apiPort}\`` : ''}`);
-    }
-    if (appPort || apiPort) {
-        lines.push('- The `*.localhost` names are resolved by BROWSERS. Node, `curl` and other tools may not resolve them (they do not on Windows) — use the loopback address from a script.');
+    //
+    // The loopback address is named by its env var, never by its port. This file is
+    // committed, and the internal port is allocated per machine (4000 + whatever the
+    // other registered projects took), so writing `127.0.0.1:4031` here left every
+    // checkout modified after `lt dev up`, and committing it only moved the diff to
+    // the next developer. The env var names are the same everywhere.
+    if (appSub)
+        lines.push(`- App: \`https://${appSub.hostname}\``);
+    if (apiSub)
+        lines.push(`- API: \`https://${apiSub.hostname}\``);
+    const loopbackVars = [
+        ...(appSub ? ['`LT_DEV_APP_INTERNAL_URL`'] : []),
+        ...(apiSub ? ['`LT_DEV_API_INTERNAL_URL`'] : []),
+    ];
+    if (loopbackVars.length > 0) {
+        lines.push(`- The \`*.localhost\` names are resolved by BROWSERS. Node, \`curl\` and other tools may not resolve them (they do not on Windows), so a script uses the loopback address: ${loopbackVars.join(' / ')} (set in the processes and in \`.lt-dev/.env\`), or the \`→ 127.0.0.1:<port>\` that \`lt dev status\` prints. The port differs per machine, which is why it is not written here.`);
     }
     if (dbName)
         lines.push(`- DB: \`mongodb://127.0.0.1/${dbName}\``);

package/package.json

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