instar 1.3.228 → 1.3.230

package/dist/commands/devProfileNode.js

@@ -0,0 +1,179 @@
+/**
+ * `instar dev:profile-node [pid]` — CPU-profile a RUNNING node process and print
+ * the hottest JS functions (function + file:line + self-time %).
+ *
+ * Why this exists: macOS `sample` (and lsof snapshots, `gh run --log`, etc.) can't
+ * symbolicate a node process's JS frames — they show only native/V8 frames, so a
+ * busy node server's actual hot *function* stays invisible. This wraps the
+ * technique that DOES see it: SIGUSR1 opens node's inspector on the running
+ * process, then a CDP CPU profile over the inspector websocket reports the exact
+ * JS call frames. (This is how the StateManager.listSessions hot-loop was pinned —
+ * 30% of CPU in readFileUtf8 under listSessions, invisible to every other tool.)
+ *
+ * Side effect: SIGUSR1 opens the inspector on 127.0.0.1 (localhost-only) for the
+ * life of the process; it closes when the process restarts. The command says so.
+ * Read-only otherwise — it samples, it never mutates the target.
+ */
+import { execFile } from 'node:child_process';
+import pc from 'picocolors';
+const INSPECTOR_PORTS = [9229, 9230, 9231, 9232, 9233, 9234, 9235];
+const DEFAULT_TOP = 15;
+const DEFAULT_DURATION_SEC = 5;
+/**
+ * Pure: aggregate a CDP CPU profile's self-time (per-node `hitCount`) by JS call
+ * frame, returning the top-N frames as `function  src/file.js:line` + self %.
+ * The biggest non-idle entry IS the hot loop. Idle/native frames (`(idle)`,
+ * `(program)`, GC) are kept — seeing "48% idle, 30% readFileUtf8" is the signal.
+ */
+export function aggregateHotFrames(profile, topN = DEFAULT_TOP) {
+    const self = new Map();
+    for (const n of profile.nodes ?? []) {
+        const f = n.callFrame ?? {};
+        const fn = f.functionName && f.functionName.length > 0 ? f.functionName : '(anonymous)';
+        const loc = f.url ? `${f.url.replace(/^.*\/(dist|src)\//, '$1/')}:${(f.lineNumber ?? -1) + 1}` : '';
+        const key = loc ? `${fn}  ${loc}` : fn;
+        self.set(key, (self.get(key) ?? 0) + (n.hitCount ?? 0));
+    }
+    const total = [...self.values()].reduce((a, b) => a + b, 0) || 1;
+    return [...self.entries()]
+        .map(([label, samples]) => ({ label, samples, selfPct: Math.round((1000 * samples) / total) / 10 }))
+        .sort((a, b) => b.samples - a.samples)
+        .slice(0, topN);
+}
+/** Probe the inspector ports for the target opened by SIGUSR1. First hit wins. */
+export async function findInspectorTarget(deps) {
+    for (const port of INSPECTOR_PORTS) {
+        try {
+            const t = await deps.fetchInspectorTarget(port);
+            if (t?.webSocketDebuggerUrl)
+                return t;
+        }
+        catch { /* try the next port */ }
+    }
+    return null;
+}
+/**
+ * Orchestrate: resolve pid → SIGUSR1 → find inspector → CDP CPU profile →
+ * aggregate → print. Returns an exit code (0 ok, 1 operational failure).
+ */
+export async function runDevProfileNode(opts) {
+    const out = opts.output ?? { write: (t) => process.stdout.write(t), error: (t) => process.stderr.write(t) };
+    const deps = opts.deps ?? productionDeps();
+    const durationMs = Math.max(1, opts.durationSec ?? DEFAULT_DURATION_SEC) * 1000;
+    const topN = opts.top ?? DEFAULT_TOP;
+    let pid = null;
+    if (opts.pid && /^\d+$/.test(opts.pid)) {
+        pid = parseInt(opts.pid, 10);
+    }
+    else {
+        pid = await deps.hottestNodePid();
+        if (pid == null) {
+            out.error(pc.red('No running node process found to profile.\n'));
+            return 1;
+        }
+        out.write(pc.dim(`No pid given — profiling the hottest node process: ${pid}\n`));
+    }
+    try {
+        deps.signalUsr1(pid);
+    }
+    catch {
+        out.error(pc.red(`Could not signal pid ${pid} (is it alive? is it a node process?).\n`));
+        return 1;
+    }
+    // The inspector takes a moment to bind after SIGUSR1.
+    await deps.sleep(800);
+    const target = await findInspectorTarget(deps);
+    if (!target?.webSocketDebuggerUrl) {
+        out.error(pc.red(`pid ${pid} did not expose a node inspector on 127.0.0.1:9229-9235.\n` +
+            `It may not be a node process, or the inspector is already bound elsewhere.\n`));
+        return 1;
+    }
+    out.write(pc.dim(`Profiling ${pid} for ${durationMs / 1000}s via the inspector…\n`));
+    let profile;
+    try {
+        profile = await deps.captureCpuProfile(target.webSocketDebuggerUrl, durationMs);
+    }
+    catch (err) {
+        out.error(pc.red(`CPU profile failed: ${err instanceof Error ? err.message : String(err)}\n`));
+        return 1;
+    }
+    const frames = aggregateHotFrames(profile, topN);
+    if (frames.length === 0) {
+        out.error(pc.yellow('Profile captured but no samples — try a longer --duration.\n'));
+        return 0;
+    }
+    out.write(pc.bold(`\nHottest JS frames (self-time) for pid ${pid}:\n`));
+    for (const f of frames) {
+        const pct = `${f.selfPct.toFixed(1)}%`.padStart(6);
+        out.write(`  ${pc.cyan(pct)}  ${f.label}\n`);
+    }
+    out.write(pc.dim(`\n(The biggest non-idle frame is the hot path. SIGUSR1 left the inspector ` +
+        `open on 127.0.0.1 for pid ${pid}; it closes on the process's next restart.)\n`));
+    return 0;
+}
+/** Production deps: real SIGUSR1, http inspector probe, ws CDP profile, ps. */
+export function productionDeps() {
+    return {
+        signalUsr1(pid) { process.kill(pid, 'SIGUSR1'); },
+        async fetchInspectorTarget(port) {
+            const res = await fetch(`http://127.0.0.1:${port}/json/list`, { signal: AbortSignal.timeout(2000) });
+            if (!res.ok)
+                return null;
+            const list = (await res.json());
+            return Array.isArray(list) && list.length > 0 ? list[0] : null;
+        },
+        async captureCpuProfile(wsUrl, durationMs) {
+            const { WebSocket } = await import('ws');
+            return await new Promise((resolve, reject) => {
+                const ws = new WebSocket(wsUrl, { maxPayload: 512 * 1024 * 1024 });
+                let id = 0;
+                const pending = new Map();
+                const send = (method, params = {}) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method, params })); });
+                const fail = (e) => { try {
+                    ws.close();
+                }
+                catch { /* noop */ } reject(e); };
+                const timer = setTimeout(() => fail(new Error('inspector timed out')), durationMs + 15000);
+                ws.on('message', (m) => {
+                    const o = JSON.parse(m.toString());
+                    if (o.id != null && pending.has(o.id)) {
+                        pending.get(o.id)(o.result);
+                        pending.delete(o.id);
+                    }
+                });
+                ws.on('error', (e) => { clearTimeout(timer); fail(e); });
+                ws.on('open', () => {
+                    void (async () => {
+                        await send('Profiler.enable');
+                        await send('Profiler.setSamplingInterval', { interval: 100 });
+                        await send('Profiler.start');
+                        await new Promise((r) => setTimeout(r, durationMs));
+                        const stop = (await send('Profiler.stop'));
+                        clearTimeout(timer);
+                        try {
+                            ws.close();
+                        }
+                        catch { /* noop */ }
+                        resolve(stop.profile ?? {});
+                    })().catch(fail);
+                });
+            });
+        },
+        async hottestNodePid() {
+            return await new Promise((resolve) => {
+                execFile('ps', ['-Aceo', 'pcpu,pid,comm'], { timeout: 5000 }, (err, stdout) => {
+                    if (err) {
+                        resolve(null);
+                        return;
+                    }
+                    const hot = stdout.split('\n').map((l) => l.trim().match(/^([\d.]+)\s+(\d+)\s+(.+)$/))
+                        .filter((m) => !!m && m[3] === 'node')
+                        .sort((a, b) => parseFloat(b[1]) - parseFloat(a[1]))[0];
+                    resolve(hot ? parseInt(hot[2], 10) : null);
+                });
+            });
+        },
+        sleep(ms) { return new Promise((r) => setTimeout(r, ms)); },
+    };
+}
+//# sourceMappingURL=devProfileNode.js.map

package/dist/commands/devProfileNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devProfileNode.js","sourceRoot":"","sources":["../../src/commands/devProfileNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,YAAY,CAAC;AAgC5B,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnE,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmB,EAAE,OAAe,WAAW;IAChF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;QACxF,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;SACnG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SACrC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAqB;IAC7D,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,EAAE,oBAAoB;gBAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAA2B;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;IAErC,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAClC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;YAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAChG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,sDAAsD,GAAG,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,CAAC;QAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAC7B,MAAM,CAAC;QAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,GAAG,0CAA0C,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAE7G,sDAAsD;IACtD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAClC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,GAAG,4DAA4D;YACrF,8EAA8E,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,aAAa,GAAG,QAAQ,UAAU,GAAG,IAAI,wBAAwB,CAAC,CAAC,CAAC;IACrF,IAAI,OAAmB,CAAC;IACxB,IAAI,CAAC;QAAC,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IAAC,CAAC;IACxF,OAAO,GAAG,EAAE,CAAC;QAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAEzH,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,8DAA8D,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAE5H,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,2CAA2C,GAAG,KAAK,CAAC,CAAC,CAAC;IACxE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnD,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,4EAA4E;QAC3F,6BAA6B,GAAG,+CAA+C,CAAC,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,oBAAoB,CAAC,IAAI;YAC7B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrG,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;YACrD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,CAAC;QACD,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,UAAU;YACvC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,MAAM,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACvD,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;gBACnE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAAC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;gBACpE,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,SAAkC,EAAE,EAAE,EAAE,CACpE,IAAI,OAAO,CAAU,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1H,MAAM,IAAI,GAAG,CAAC,CAAQ,EAAE,EAAE,GAAG,IAAI,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;gBAC3F,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAkB,EAAE,EAAE;oBACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAsC,CAAC;oBACxE,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;wBAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;wBAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAAC,CAAC;gBAChG,CAAC,CAAC,CAAC;gBACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;oBAAG,KAAK,CAAC,KAAK,IAAI,EAAE;wBACrC,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC;wBAC9B,MAAM,IAAI,CAAC,8BAA8B,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;wBAC9D,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC;wBAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;wBACpD,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,CAA6B,CAAC;wBACvE,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,IAAI,CAAC;4BAAC,EAAE,CAAC,KAAK,EAAE,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;wBACxC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBAC9B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,OAAO,MAAM,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;gBAClD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;oBAC5E,IAAI,GAAG,EAAE,CAAC;wBAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAAC,OAAO;oBAAC,CAAC;oBACnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;yBACnF,MAAM,CAAC,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;yBAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,EAAE,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/commands/server.js

@@ -6307,7 +6307,8 @@ export async function startServer(options) {
                             void captureAndDistill({
                                 ring,
                                 ledger: correctionLedger,
-                                distill: (prompt) => correctionLlmQueue.enqueue('background', () => sharedIntelligence.evaluate(prompt, { model: 'fast', maxTokens: 400, temperature: 0 }), 0.3),
+                                distill: (prompt) => correctionLlmQueue.enqueue('background', () => sharedIntelligence.evaluate(prompt, { model: 'fast', maxTokens: 400, temperature: 0, attribution: { component: 'server:correction-learning' } }), // attribution for /metrics/features
+                                0.3),
                                 shouldShed: () => {
                                     const r = quotaTracker?.getRecommendation();
                                     return r === 'critical' || r === 'stop';
@@ -7139,7 +7140,7 @@ export async function startServer(options) {
                     .listActive()
                     .map(({ threadId, entry }) => ({ threadId, peerName: entry.remoteAgent ?? 'peer', topicId: entry.originTopicId }))
                     .filter((t) => typeof t.topicId === 'number'),
-                summarize: (prompt) => sharedLlmQueue.enqueue('background', () => intelligence.evaluate(prompt, { model: 'fast' })),
+                summarize: (prompt) => sharedLlmQueue.enqueue('background', () => intelligence.evaluate(prompt, { model: 'fast', attribution: { component: 'server:a2a-checkin' } })), // attribution for /metrics/features
                 surface: async ({ topicId, body }) => {
                     if (typeof topicId === 'number')
                         await tg.sendToTopic(topicId, body);