lensmcp 1.16.23 → 1.16.25

package/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAqED,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAwChE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAqFD,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA4ChE"}

package/lib/cli.js

@@ -1,6 +1,7 @@
 import { spawn, spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, openSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
+import { request as httpRequest } from 'node:http';
+import { homedir, tmpdir } from 'node:os';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { ensureLensConfig } from './workspace-scope.js';
@@ -67,6 +68,22 @@ Commands:
                        promote, abort, add-rule, remove-rule, status. Validated +
                        atomic write; the prod gateway picks it up live. Run
                        \`lensmcp rollout\` (no args) for the op list.
+  logs [service] [--tail <n>] [--no-follow] [--plain] [--cwd <dir>]
+                       Attach this terminal to a running service's live log
+                       stream (docker-logs style — for humans and agents alike).
+                       No <service> lists every attachable service across
+                       workspaces. --tail <n> replays that many history lines
+                       first (default 100); --no-follow prints them and exits
+                       (the agent-friendly snapshot); --plain strips ANSI color
+                       (automatic when output is piped). Needs no ports — it
+                       finds the devserver's control socket under $TMPDIR.
+  debug <service> [--port <base>] [--cwd <dir>]
+                       Open every pod's Node inspector of a RUNNING service —
+                       in place, no restart, app state intact — and print the
+                       ws:// attach URLs (pods on base+slot, workers get
+                       SIGUSR1). Then attach WebStorm (Attach to Node.js/
+                       Chrome) to the printed port, or click the "Debugger
+                       listening" link in \`lensmcp logs <service>\`.
   --version            Print the lensmcp version.
   --help               Show this help.
 `;
@@ -101,6 +118,10 @@ export async function runCli(ctx) {
             return runDoctor(ctx, rest, out);
         case 'rollout':
             return runRollout(ctx, rest, err);
+        case 'logs':
+            return runLogs(ctx, rest, out, err);
+        case 'debug':
+            return runDebug(ctx, rest, out, err);
         default:
             err(`Unknown command: ${command}`);
             err(HELP);
@@ -1164,7 +1185,162 @@ function ensureLensmcpDir(cwd) {
 function isInteractive() {
     return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
-/** Narrow a flag value to string-or-undefined, treating booleans as absent. */
+/** Find every running devserver's control socket: `$TMPDIR[/<wsKey>]/<service>-devserver/parent.sock`
+ *  — the same path derivation the devserver (`main.devserver.ts` SOCK_DIR) and the
+ *  gateway's pod discovery use. A socket file may be stale (crashed parent); the
+ *  attach attempt reports that rather than this scan. */
+function discoverDevserverSocks() {
+    const base = tmpdir();
+    const found = [];
+    const scan = (dir, wsKey) => {
+        try {
+            for (const e of readdirSync(dir, { withFileTypes: true })) {
+                if (!e.isDirectory() || !e.name.endsWith('-devserver'))
+                    continue;
+                const sock = join(dir, e.name, 'parent.sock');
+                if (existsSync(sock)) {
+                    found.push({ service: e.name.slice(0, -'-devserver'.length), wsKey, sock });
+                }
+            }
+        }
+        catch {
+            /* unreadable dir — not ours, skip */
+        }
+    };
+    scan(base, '');
+    try {
+        for (const e of readdirSync(base, { withFileTypes: true })) {
+            // workspace keys are slugs — skip the rest of the tmp noise
+            if (e.isDirectory() && /^[a-z0-9][a-z0-9-]*$/.test(e.name) && !e.name.endsWith('-devserver')) {
+                scan(join(base, e.name), e.name);
+            }
+        }
+    }
+    catch {
+        /* no tmpdir — nothing to list */
+    }
+    return found.sort((a, b) => `${a.wsKey}/${a.service}`.localeCompare(`${b.wsKey}/${b.service}`));
+}
+const fullServiceName = (d) => (d.wsKey ? `${d.wsKey}/${d.service}` : d.service);
+/** Resolve a service argument (`name` or `wsKey/name`) to ONE control socket. A bare
+ *  name running in several workspaces is disambiguated by the current workspace's key.
+ *  Prints the helpful error itself and returns null when nothing (or too much) matches. */
+function resolveServiceSock(service, all, cwd, err) {
+    let matches = all.filter((d) => d.service === service || fullServiceName(d) === service);
+    if (matches.length > 1) {
+        try {
+            const key = ensureLensConfig(cwd).key;
+            const scoped = matches.filter((d) => d.wsKey === key);
+            if (scoped.length === 1)
+                matches = scoped;
+        }
+        catch {
+            /* not inside a workspace — keep it ambiguous and say so below */
+        }
+    }
+    if (matches.length === 0) {
+        err(`No running service named "${service}".`);
+        if (all.length > 0)
+            err(`Running: ${all.map(fullServiceName).join(', ')}`);
+        return null;
+    }
+    if (matches.length > 1) {
+        err(`"${service}" is ambiguous — use one of: ${matches.map(fullServiceName).join(', ')}`);
+        return null;
+    }
+    return matches[0];
+}
+async function runLogs(ctx, args, out, err) {
+    const opts = parseFlags(args, {
+        string: ['--tail', '--cwd'],
+        boolean: ['--no-follow', '--plain'],
+    });
+    const service = opts.positional[0];
+    const all = discoverDevserverSocks();
+    if (!service) {
+        if (all.length === 0) {
+            out('No running services found (no devserver control sockets under $TMPDIR).');
+            out('Start one with `yarn nx serve <project>` or `lensmcp gateway start`.');
+        }
+        else {
+            out('Running services — attach with `lensmcp logs <service>`:');
+            for (const d of all)
+                out(`  ${fullServiceName(d)}`);
+        }
+        return { exitCode: 0 };
+    }
+    const target = resolveServiceSock(service, all, resolve(stringFlag(opts.flags['--cwd']) ?? ctx.cwd), err);
+    if (!target)
+        return { exitCode: 1 };
+    const follow = opts.flags['--no-follow'] !== true;
+    const tailRaw = Number(stringFlag(opts.flags['--tail']) ?? NaN);
+    const tail = Number.isInteger(tailRaw) && tailRaw >= 0 ? tailRaw : 100; // 0 = live-only, no history
+    const plain = opts.flags['--plain'] === true || !process.stdout.isTTY;
+    const reqPath = `/webpack/logs?tail=${tail}&follow=${follow ? 1 : 0}${plain ? '&plain=1' : ''}`;
+    return new Promise((done) => {
+        const req = httpRequest({ socketPath: target.sock, path: reqPath, method: 'GET' }, (res) => {
+            // Raw stream passthrough — chunks go straight to the terminal, bypassing the
+            // line-based out() (which would re-buffer and add newlines).
+            res.on('data', (chunk) => process.stdout.write(chunk));
+            res.on('end', () => done({ exitCode: 0 }));
+            res.on('error', () => done({ exitCode: 1 }));
+        });
+        req.on('error', (e) => {
+            err(`Cannot attach to ${fullServiceName(target)}: ${e.message}`);
+            err('The devserver may have crashed leaving a stale socket — restart the service and retry.');
+            done({ exitCode: 1 });
+        });
+        req.end();
+    });
+}
+async function runDebug(ctx, args, out, err) {
+    const opts = parseFlags(args, { string: ['--port', '--cwd'] });
+    const service = opts.positional[0];
+    const all = discoverDevserverSocks();
+    if (!service) {
+        err('Usage: lensmcp debug <service> [--port <base>]');
+        if (all.length > 0)
+            err(`Running: ${all.map(fullServiceName).join(', ')}`);
+        return { exitCode: 2 };
+    }
+    const target = resolveServiceSock(service, all, resolve(stringFlag(opts.flags['--cwd']) ?? ctx.cwd), err);
+    if (!target)
+        return { exitCode: 1 };
+    const port = Number(stringFlag(opts.flags['--port']) ?? '') || undefined;
+    const reqPath = `/webpack/debug${port ? `?port=${port}` : ''}`;
+    const body = await new Promise((done) => {
+        const req = httpRequest({ socketPath: target.sock, path: reqPath, method: 'POST' }, (res) => {
+            let b = '';
+            res.on('data', (c) => (b += c));
+            res.on('end', () => done(b));
+            res.on('error', () => done(null));
+        });
+        req.on('error', () => done(null));
+        req.end();
+    });
+    if (body === null) {
+        err(`Cannot reach ${fullServiceName(target)} — the devserver may have crashed leaving a stale socket.`);
+        return { exitCode: 1 };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        err(`Unexpected response from the devserver: ${body.slice(0, 200)}`);
+        return { exitCode: 1 };
+    }
+    out(`Inspectors open on ${fullServiceName(target)} — in place, no restart:`);
+    for (const p of parsed.pods ?? []) {
+        out(`  pod #${p.id}   ${p.inspectorUrl ?? '(no url reported — check lensmcp logs)'}`);
+    }
+    for (const w of parsed.workers ?? []) {
+        out(`  worker ${w.name}   127.0.0.1:${w.port}`);
+    }
+    out(`Attach WebStorm (Run → Attach to Node.js/Chrome) to 127.0.0.1:${parsed.basePort ?? '?'} — ` +
+        `or click the "Debugger listening" link in \`lensmcp logs ${service}\`.`);
+    return { exitCode: 0 };
+}
 function stringFlag(v) {
     if (v === undefined)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lensmcp",
-  "version": "1.16.23",
+  "version": "1.16.25",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",

package/plugin/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "lensmcp",
   "displayName": "LensMCP",
   "description": "The observability lens for coding agents. One command brings up the dev cluster gateway (every project.json `cluster` decl → its host on :443), the per-project lens dashboard at https://lensmcp.local/<project>/, and the MCP server your agent connects to — scoped automatically to whatever project you opened Claude Code in.",
-  "version": "1.16.23",
+  "version": "1.16.25",
   "author": {
     "name": "David Antoon",
     "email": "davidmantoon@gmail.com"