ysk-server-core 1.0.0

package/dist/monitoring/process-signal.js

@@ -0,0 +1,289 @@
+import { tl } from 'ysk-server-shared';
+export const PROCESS_SIGNALS = [
+    'TERM',
+    'KILL',
+    'HUP',
+    'USR1',
+];
+const SIG_NAME = {
+    TERM: 'SIGTERM',
+    KILL: 'SIGKILL',
+    HUP: 'SIGHUP',
+    USR1: 'SIGUSR1',
+};
+export function isProcessSignal(v) {
+    return typeof v === 'string' && PROCESS_SIGNALS.includes(v);
+}
+/**
+ * Normalize and validate PID string. Returns null if invalid / protected init.
+ */
+export function normalizePid(raw) {
+    const s = String(raw ?? '').trim();
+    if (!/^\d+$/.test(s)) {
+        return { ok: false, reason: tl('notes.auto.n0149') };
+    }
+    // no leading zeros abuse; allow "01" → treat as number
+    const n = Number(s);
+    if (!Number.isSafeInteger(n) || n < 1) {
+        return { ok: false, reason: tl('notes.auto.n0150') };
+    }
+    if (n === 1) {
+        return { ok: false, reason: tl('notes.auto.n0875') };
+    }
+    return { ok: true, pid: String(n) };
+}
+function looksLikeControlPlane(cmd) {
+    const c = cmd.toLowerCase();
+    return (c.includes('ysk-server') ||
+        c.includes('ysk-server') ||
+        /\/ysk-server(\s|$)/.test(c) ||
+        /node.*apps\/server/.test(c));
+}
+/**
+ * Read process cmdline via host (honest empty when unreadable).
+ */
+export async function readProcessCmdline(host, pid) {
+    const r = await host.runCommand(['bash', '-c', `tr '\\0' ' ' < /proc/${pid}/cmdline 2>/dev/null | head -c 400`], { timeoutMs: 3_000 });
+    if (r.exitCode !== 0)
+        return undefined;
+    const t = r.stdout.trim();
+    return t || undefined;
+}
+/**
+ * Lightweight /proc detail for drawer.
+ */
+export async function collectProcessDetail(host, pidRaw) {
+    const norm = normalizePid(pidRaw);
+    if (!norm.ok) {
+        return { ok: false, pid: String(pidRaw), notes: [norm.reason] };
+    }
+    const pid = norm.pid;
+    const notes = [];
+    const command = await readProcessCmdline(host, pid);
+    if (!command)
+        notes.push(tl('notes.auto.n1183'));
+    let cwd;
+    const cwdR = await host.runCommand(['bash', '-c', `readlink /proc/${pid}/cwd 2>/dev/null`], { timeoutMs: 3_000 });
+    if (cwdR.exitCode === 0 && cwdR.stdout.trim()) {
+        cwd = cwdR.stdout.trim();
+    }
+    else {
+        notes.push(tl('notes.auto.n0242'));
+    }
+    let fdCount;
+    const fdR = await host.runCommand(['bash', '-c', `ls /proc/${pid}/fd 2>/dev/null | wc -l`], { timeoutMs: 3_000 });
+    if (fdR.exitCode === 0) {
+        const n = Number(fdR.stdout.trim());
+        if (Number.isFinite(n))
+            fdCount = n;
+    }
+    else {
+        notes.push(tl('notes.auto.n0289'));
+    }
+    return {
+        ok: Boolean(command || cwd || fdCount != null),
+        pid,
+        command,
+        cwd,
+        fdCount,
+        notes,
+    };
+}
+/**
+ * Adjust process nice value (-20..19). Requires YSK_EXECUTE.
+ * Uses `renice -n N -p PID` (relative) when absolute not available we use absolute via renice.
+ */
+export async function reniceProcess(input) {
+    const notes = [];
+    const executeEnabled = input.host.executeEnabled();
+    const norm = normalizePid(input.pid);
+    if (!norm.ok) {
+        return {
+            ok: false,
+            pid: String(input.pid),
+            notes: [norm.reason],
+            executeEnabled,
+        };
+    }
+    const pid = norm.pid;
+    const nice = Math.floor(Number(input.nice));
+    if (!Number.isFinite(nice) || nice < -20 || nice > 19) {
+        return {
+            ok: false,
+            pid,
+            notes: [tl('notes.auto.n0345')],
+            executeEnabled,
+        };
+    }
+    if (Number(pid) === process.pid) {
+        return {
+            ok: false,
+            blocked: true,
+            blockMessage: tl('notes.auto.n0870'),
+            pid,
+            notes: [tl('notes.auto.n0557')],
+            executeEnabled,
+        };
+    }
+    if (!executeEnabled) {
+        return {
+            ok: false,
+            blocked: true,
+            blockMessage: tl('ops.blocked.renice'),
+            pid,
+            notes: [tl('ops.blocked.needExecuteYsk')],
+            executeEnabled,
+        };
+    }
+    // renice -n sets absolute on many systems when used as `renice N -p PID`
+    const r = await input.host.runCommand(['renice', String(nice), '-p', pid], { timeoutMs: 5_000 });
+    if (r.exitCode !== 0) {
+        return {
+            ok: false,
+            pid,
+            nice,
+            notes: [
+                tl('notes.tpl.reniceFailed', { detail: (r.stderr || r.stdout || '').trim().slice(0, 200) || `exit ${r.exitCode}` }),
+            ],
+            executeEnabled,
+        };
+    }
+    notes.push(`PID ${pid} nice → ${nice}`);
+    // verify via ps
+    const ps = await input.host.runCommand(['ps', '-o', 'ni=', '-p', pid], { timeoutMs: 3_000 });
+    if (ps.exitCode === 0 && ps.stdout.trim()) {
+        notes.push(tl('notes.auto.t0440', { v0: (ps.stdout.trim()) }));
+    }
+    return { ok: true, pid, nice, notes, executeEnabled };
+}
+export async function signalProcess(input) {
+    const notes = [];
+    const executeEnabled = input.host.executeEnabled();
+    const signal = input.signal;
+    if (!isProcessSignal(signal)) {
+        return {
+            ok: false,
+            pid: String(input.pid),
+            signal: 'TERM',
+            notes: [tl('notes.auto.n0498')],
+            executeEnabled,
+        };
+    }
+    const norm = normalizePid(input.pid);
+    if (!norm.ok) {
+        return {
+            ok: false,
+            pid: String(input.pid),
+            signal,
+            notes: [norm.reason],
+            executeEnabled,
+        };
+    }
+    const pid = norm.pid;
+    // Self-protect
+    if (Number(pid) === process.pid && !input.forceSelf) {
+        return {
+            ok: false,
+            blocked: true,
+            blockMessage: tl('notes.auto.n0877'),
+            pid,
+            signal,
+            notes: [tl('notes.auto.t0441', { v0: (pid) })],
+            executeEnabled,
+            command: process.argv.join(' ').slice(0, 200),
+        };
+    }
+    let command = await readProcessCmdline(input.host, pid);
+    if (command) {
+        notes.push(`cmdline: ${command.slice(0, 160)}`);
+    }
+    if (command &&
+        looksLikeControlPlane(command) &&
+        Number(pid) !== process.pid &&
+        !input.forceControlPlane &&
+        !input.forceSelf) {
+        return {
+            ok: false,
+            blocked: true,
+            blockMessage: tl('notes.auto.n0876'),
+            pid,
+            signal,
+            notes: [...notes, tl('notes.auto.n0240')],
+            executeEnabled,
+            command,
+        };
+    }
+    if (!executeEnabled) {
+        return {
+            ok: false,
+            blocked: true,
+            blockMessage: tl('ops.blocked.signal'),
+            pid,
+            signal,
+            notes: [...notes, tl('ops.blocked.signalNote')],
+            executeEnabled,
+            command,
+        };
+    }
+    // Existence check first
+    const probe0 = await input.host.runCommand(['kill', '-0', pid], { timeoutMs: 3_000 });
+    if (probe0.exitCode !== 0) {
+        notes.push(tl('notes.auto.t0442', { v0: (probe0.exitCode) }));
+        return {
+            ok: false,
+            pid,
+            signal,
+            stillAlive: false,
+            notes: [
+                ...notes,
+                (probe0.stderr || probe0.stdout || '').trim().slice(0, 160) || tl('notes.auto.n0316'),
+            ],
+            executeEnabled,
+            command,
+        };
+    }
+    const sigName = SIG_NAME[signal];
+    const killR = await input.host.runCommand(['kill', '-s', sigName, pid], {
+        timeoutMs: 5_000,
+    });
+    if (killR.exitCode !== 0) {
+        const err = (killR.stderr || killR.stdout || '').trim().slice(0, 200);
+        notes.push(tl('notes.tpl.killFailed', { sig: sigName, detail: err || `exit ${killR.exitCode}` }));
+        // still probe
+        const still = await input.host.runCommand(['kill', '-0', pid], { timeoutMs: 3_000 });
+        return {
+            ok: false,
+            pid,
+            signal,
+            stillAlive: still.exitCode === 0,
+            notes,
+            executeEnabled,
+            command,
+        };
+    }
+    notes.push(tl('notes.auto.t0444', { v0: (sigName), v1: (pid) }));
+    // Brief settle for TERM
+    if (signal === 'TERM') {
+        await new Promise((r) => setTimeout(r, 120));
+    }
+    const still = await input.host.runCommand(['kill', '-0', pid], { timeoutMs: 3_000 });
+    const stillAlive = still.exitCode === 0;
+    if (stillAlive) {
+        notes.push(signal === 'KILL'
+            ? tl('notes.auto.n0315')
+            : tl('notes.auto.n1469'));
+    }
+    else {
+        notes.push(tl('notes.auto.n1470'));
+    }
+    return {
+        ok: true,
+        pid,
+        signal,
+        stillAlive,
+        notes,
+        executeEnabled,
+        command,
+    };
+}
+//# sourceMappingURL=process-signal.js.map

package/dist/monitoring/process-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-signal.js","sourceRoot":"","sources":["../../src/monitoring/process-signal.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/process-snapshot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Process table snapshot — real `ps` + top-style header (honest, no fake rows).
+ */
+import type { ProcessRowDto, ProcessSnapshotDto, ProcessSort } from 'ysk-server-shared';
+import type { HostExecutor } from '../host/executor.js';
+export type ProcessRow = ProcessRowDto;
+export type ProcessSnapshot = ProcessSnapshotDto;
+export type { ProcessSort };
+/**
+ * Parse rich `ps -eo pid,user,pri,ni,vsz,rss,stat,pcpu,pmem,time,etime,args`.
+ * Also accepts simpler legacy layouts.
+ */
+export declare function parsePsOutput(stdout: string, limit: number): ProcessRow[];
+export declare function collectProcessSnapshot(host: HostExecutor, opts?: {
+    sort?: ProcessSort;
+    limit?: number;
+    includeTop?: boolean;
+    includeHeader?: boolean;
+    sampleMs?: number;
+}): Promise<ProcessSnapshot>;
+//# sourceMappingURL=process-snapshot.d.ts.map

package/dist/monitoring/process-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-snapshot.d.ts","sourceRoot":"","sources":["../../src/monitoring/process-snapshot.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AACvC,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,CAAC;AAwB5B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAsEzE;AAsBD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,YAAY,EAClB,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,eAAe,CAAC,CA2G1B"}

package/dist/monitoring/process-snapshot.js

@@ -0,0 +1,219 @@
+import { tl } from 'ysk-server-shared';
+import { collectTopHeader } from './top-snapshot.js';
+function parseKiB(raw) {
+    const t = raw.trim().toUpperCase();
+    if (!t || t === '-')
+        return undefined;
+    // plain number (ps vsz/rss often KiB)
+    if (/^\d+$/.test(t)) {
+        const n = Number(t);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    // 1.4g / 53.6g style from some ps formats — rare with -o vsz
+    const m = t.match(/^([\d.]+)([KMG])?$/);
+    if (!m)
+        return undefined;
+    let n = Number(m[1]);
+    if (!Number.isFinite(n))
+        return undefined;
+    const u = m[2];
+    if (u === 'G')
+        n *= 1024 * 1024;
+    else if (u === 'M')
+        n *= 1024;
+    else if (u === 'K' || !u) {
+        /* already KiB-ish */
+    }
+    return Math.round(n);
+}
+/**
+ * Parse rich `ps -eo pid,user,pri,ni,vsz,rss,stat,pcpu,pmem,time,etime,args`.
+ * Also accepts simpler legacy layouts.
+ */
+export function parsePsOutput(stdout, limit) {
+    const lines = stdout.split('\n').map((l) => l.trimEnd()).filter((l) => l.trim());
+    if (lines.length < 2)
+        return [];
+    const rows = [];
+    for (const line of lines.slice(1)) {
+        const t = line.trim();
+        // Full: pid user pri ni vsz rss stat pcpu pmem time etime args
+        // STAT may be multi-char (Ss, Rsl…); TIME/ELAPSED are single tokens
+        const full = t.match(/^(\d+)\s+(\S+)\s+(\S+)\s+(-?\d+)\s+(\d+)\s+(\d+)\s+(\S+)\s+([\d.]+)\s+([\d.]+)\s+(\S+)\s+(\S+)\s+(.*)$/);
+        if (full) {
+            const cpu = Number(full[8]);
+            const mem = Number(full[9]);
+            if (!Number.isFinite(cpu) || !Number.isFinite(mem))
+                continue;
+            rows.push({
+                pid: full[1],
+                user: full[2],
+                pr: full[3],
+                ni: Number(full[4]),
+                virtKiB: parseKiB(full[5]),
+                resKiB: parseKiB(full[6]),
+                state: full[7],
+                cpu,
+                mem,
+                timePlus: full[10],
+                etime: full[11],
+                command: (full[12] || '').trim().slice(0, 200) || '—',
+            });
+            if (rows.length >= limit)
+                break;
+            continue;
+        }
+        // Mid: pid user pcpu pmem etime args
+        const withEtime = t.match(/^(\d+)\s+(\S+)\s+([\d.]+)\s+([\d.]+)\s+(\d+-\d+:\d+:\d+|\d+:\d+:\d+|\d+:\d+)\s+(.*)$/);
+        if (withEtime) {
+            const cpu = Number(withEtime[3]);
+            const mem = Number(withEtime[4]);
+            if (!Number.isFinite(cpu) || !Number.isFinite(mem))
+                continue;
+            rows.push({
+                pid: withEtime[1],
+                user: withEtime[2],
+                cpu,
+                mem,
+                etime: withEtime[5],
+                command: (withEtime[6] || '').trim().slice(0, 200) || '—',
+            });
+            if (rows.length >= limit)
+                break;
+            continue;
+        }
+        // Legacy: pid user pcpu pmem args
+        const m = t.match(/^(\d+)\s+(\S+)\s+([\d.]+)\s+([\d.]+)\s+(.*)$/);
+        if (!m)
+            continue;
+        const cpu = Number(m[3]);
+        const mem = Number(m[4]);
+        if (!Number.isFinite(cpu) || !Number.isFinite(mem))
+            continue;
+        rows.push({
+            pid: m[1],
+            user: m[2],
+            cpu,
+            mem,
+            command: (m[5] || '').trim().slice(0, 200) || '—',
+        });
+        if (rows.length >= limit)
+            break;
+    }
+    return rows;
+}
+function sortRows(rows, sort) {
+    const copy = [...rows];
+    if (sort === 'mem')
+        copy.sort((a, b) => b.mem - a.mem);
+    else if (sort === 'pid')
+        copy.sort((a, b) => Number(a.pid) - Number(b.pid));
+    else if (sort === 'time') {
+        // Prefer timePlus string length/heuristic: longer cumulative often larger; fallback cpu
+        copy.sort((a, b) => {
+            const ta = a.timePlus ?? a.etime ?? '';
+            const tb = b.timePlus ?? b.etime ?? '';
+            if (ta !== tb) {
+                // dd-hh:mm:ss vs mm:ss — longer string or more separators ≈ more time
+                if (ta.length !== tb.length)
+                    return tb.length - ta.length;
+                return tb.localeCompare(ta);
+            }
+            return b.cpu - a.cpu;
+        });
+    }
+    else
+        copy.sort((a, b) => b.cpu - a.cpu);
+    return copy;
+}
+export async function collectProcessSnapshot(host, opts) {
+    const sort = opts?.sort === 'mem' || opts?.sort === 'time' || opts?.sort === 'pid'
+        ? opts.sort
+        : 'cpu';
+    const limit = Math.max(5, Math.min(100, opts?.limit ?? 40));
+    const notes = [];
+    const at = new Date().toISOString();
+    const includeHeader = opts?.includeHeader !== false;
+    // Fetch header in parallel with process list (header needs ~sampleMs itself)
+    const headerPromise = includeHeader
+        ? collectTopHeader(host, { sampleMs: opts?.sampleMs }).catch((e) => {
+            notes.push(tl('notes.auto.t0438', { v0: (e instanceof Error ? e.message : String(e)) }));
+            return undefined;
+        })
+        : Promise.resolve(undefined);
+    const sortFlag = sort === 'mem'
+        ? '-pmem'
+        : sort === 'pid'
+            ? 'pid'
+            : sort === 'time'
+                ? '-time'
+                : '-pcpu';
+    // Full top-like columns; args last
+    const psFields = 'pid,user,pri,ni,vsz,rss,stat,pcpu,pmem,time,etime,args';
+    const psCmd = ['ps', '-eo', psFields, `--sort=${sortFlag}`];
+    const ps = await host.runCommand(psCmd, { timeoutMs: 10_000 });
+    let rows = [];
+    if (ps.exitCode !== 0) {
+        notes.push(tl('notes.auto.t0439', { v0: ((ps.stderr || ps.stdout).slice(0, 160)) }));
+        const ps2 = await host.runCommand(['ps', '-eo', 'pid,user,pcpu,pmem,etime,args', '--sort=-pcpu'], { timeoutMs: 8_000 });
+        if (ps2.exitCode !== 0) {
+            const ps3 = await host.runCommand(['ps', '-eo', 'pid,user,pcpu,pmem,args'], { timeoutMs: 8_000 });
+            if (ps3.exitCode !== 0) {
+                notes.push(tl('notes.auto.n1002'));
+                const topHeader = await headerPromise;
+                return {
+                    ok: false,
+                    at,
+                    sort,
+                    limit,
+                    rows: [],
+                    topHeader,
+                    notes,
+                };
+            }
+            rows = sortRows(parsePsOutput(ps3.stdout, limit * 2), sort).slice(0, limit);
+            notes.push(tl('notes.auto.n0392'));
+        }
+        else {
+            rows = sortRows(parsePsOutput(ps2.stdout, limit * 2), sort).slice(0, limit);
+            notes.push(tl('notes.auto.n0393'));
+        }
+    }
+    else {
+        rows = parsePsOutput(ps.stdout, limit);
+        // If sort flag unsupported silently, re-sort client-side
+        if (sort !== 'cpu') {
+            rows = sortRows(rows, sort).slice(0, limit);
+        }
+    }
+    if (!rows.length) {
+        notes.push(tl('notes.auto.n0391'));
+        const topHeader = await headerPromise;
+        return { ok: false, at, sort, limit, rows: [], topHeader, notes };
+    }
+    let rawTop;
+    if (opts?.includeTop) {
+        const top = await host.runCommand(['bash', '-c', 'top -b -n 1 -w 512 2>/dev/null | head -n 40'], { timeoutMs: 8_000 });
+        if (top.exitCode === 0 && top.stdout.trim()) {
+            rawTop = top.stdout.trim().slice(0, 6000);
+        }
+        else {
+            notes.push(tl('notes.auto.n0448'));
+        }
+    }
+    const topHeader = await headerPromise;
+    if (topHeader?.notes?.length) {
+        notes.push(...topHeader.notes);
+    }
+    return {
+        ok: true,
+        at: topHeader?.at ?? at,
+        sort,
+        limit,
+        rows,
+        topHeader,
+        rawTop,
+        notes,
+    };
+}
+//# sourceMappingURL=process-snapshot.js.map

package/dist/monitoring/process-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-snapshot.js","sourceRoot":"","sources":["../../src/monitoring/process-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAWvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMrD,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACtC,sCAAsC;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,6DAA6D;IAC7D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACf,IAAI,CAAC,KAAK,GAAG;QAAE,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC;SAC3B,IAAI,CAAC,KAAK,GAAG;QAAE,CAAC,IAAI,IAAI,CAAC;SACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;QACzB,qBAAqB;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAa;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,IAAI,GAAiB,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,+DAA+D;QAC/D,oEAAoE;QACpE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAClB,wGAAwG,CACzG,CAAC;QACF,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7D,IAAI,CAAC,IAAI,CAAC;gBACR,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBACb,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBACX,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACnB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACzB,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;gBACd,GAAG;gBACH,GAAG;gBACH,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG;aACtD,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAM;YAChC,SAAS;QACX,CAAC;QAED,qCAAqC;QACrC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CACvB,sFAAsF,CACvF,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7D,IAAI,CAAC,IAAI,CAAC;gBACR,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;gBACjB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAClB,GAAG;gBACH,GAAG;gBACH,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;gBACnB,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG;aAC1D,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAM;YAChC,SAAS;QACX,CAAC;QAED,kCAAkC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC7D,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACT,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACV,GAAG;YACH,GAAG;YACH,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG;SAClD,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,IAAkB,EAAE,IAAiB;IACrD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,KAAK,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;SAClD,IAAI,IAAI,KAAK,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SACvE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,wFAAwF;QACxF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACjB,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACd,sEAAsE;gBACtE,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;oBAAE,OAAO,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;gBAC1D,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;;QAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAkB,EAClB,IAMC;IAED,MAAM,IAAI,GACR,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,EAAE,IAAI,KAAK,KAAK;QACnE,CAAC,CAAC,IAAI,CAAC,IAAI;QACX,CAAC,CAAC,KAAK,CAAC;IACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,KAAK,KAAK,CAAC;IAEpD,6EAA6E;IAC7E,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/D,KAAK,CAAC,IAAI,CACR,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7E,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QACJ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/B,MAAM,QAAQ,GACZ,IAAI,KAAK,KAAK;QACZ,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,IAAI,KAAK,KAAK;YACd,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,KAAK,MAAM;gBACf,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,OAAO,CAAC;IAElB,mCAAmC;IACnC,MAAM,QAAQ,GAAG,wDAAwD,CAAC;IAC1E,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,QAAQ,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAE/D,IAAI,IAAI,GAAiB,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAC/B,CAAC,IAAI,EAAE,KAAK,EAAE,+BAA+B,EAAE,cAAc,CAAC,EAC9D,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAC/B,CAAC,IAAI,EAAE,KAAK,EAAE,yBAAyB,CAAC,EACxC,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;YACF,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBACnC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC;gBACtC,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,EAAE;oBACF,IAAI;oBACJ,KAAK;oBACL,IAAI,EAAE,EAAE;oBACR,SAAS;oBACT,KAAK;iBACN,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,yDAAyD;QACzD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAC/B,CAAC,MAAM,EAAE,IAAI,EAAE,6CAA6C,CAAC,EAC7D,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC;IACtC,IAAI,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE;QACvB,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,SAAS;QACT,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/monitoring/project-usage.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Per-project disk usage for metrics panel (real `du`, reuses quota helpers).
+ */
+import type { HostExecutor } from '../host/executor.js';
+export type ProjectDiskUsageRow = {
+    projectId: string;
+    name: string;
+    domain?: string;
+    homeDir: string;
+    usedBytes: number;
+    usedMb: number;
+    quotaMb: number | null;
+    /** used/quota ratio when quota set; else null */
+    usedRatio: number | null;
+    withinQuota: boolean | null;
+    notes: string[];
+};
+export type ProjectsDiskUsageSnapshot = {
+    ok: boolean;
+    at: string;
+    items: ProjectDiskUsageRow[];
+    totalUsedBytes: number;
+    notes: string[];
+};
+export type ProjectUsageInput = {
+    id: string;
+    name: string;
+    domain?: string;
+    home_dir?: string;
+    homeDir?: string;
+    quota_mb?: number | null;
+    quotaMb?: number | null;
+};
+/**
+ * Measure each project home with real `du`. Caps concurrency to avoid load spikes.
+ */
+export declare function collectProjectsDiskUsage(input: {
+    host: HostExecutor;
+    projects: ProjectUsageInput[];
+    /** Max concurrent du (default 3) */
+    concurrency?: number;
+    /** Soft cap on projects measured (default 50) */
+    limit?: number;
+}): Promise<ProjectsDiskUsageSnapshot>;
+//# sourceMappingURL=project-usage.d.ts.map

package/dist/monitoring/project-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-usage.d.ts","sourceRoot":"","sources":["../../src/monitoring/project-usage.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA8ErC"}