ysk-server-core 1.0.0

package/dist/hosting/pm2-status.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Read-only PM2 fleet snapshot for Node/Bun runtime Processes tab.
+ * Uses pm2 jlist (allowed without YSK_EXECUTE). Never invents running apps.
+ */
+import type { HostExecutor } from '../host/executor.js';
+export type Pm2AppRow = {
+    name: string;
+    pmId: number | null;
+    pid: number | null;
+    status: string;
+    cpu: number | null;
+    memory: number | null;
+    restarts: number | null;
+    unstableRestarts: number | null;
+    /** Epoch ms when process started (pm_uptime) */
+    pmUptime: number | null;
+    mode: string;
+    instances: number | null;
+    script: string;
+    cwd: string;
+    interpreter: string;
+    nodeArgs: string;
+    port: string;
+    watching: boolean;
+    yskManaged: boolean;
+    /** Full process object from jlist for JSON modal */
+    raw: Record<string, unknown>;
+};
+export type Pm2Snapshot = {
+    available: boolean;
+    path?: string;
+    version?: string;
+    apps: Pm2AppRow[];
+    running: number;
+    stopped: number;
+    errored: number;
+    at: string;
+    notes: string[];
+};
+/**
+ * Normalize one pm2 jlist entry into a table row.
+ */
+export declare function normalizePm2App(raw: Record<string, unknown>): Pm2AppRow;
+/**
+ * Parse `pm2 jlist` stdout into rows. Empty / invalid → [].
+ * Tolerates warning prefixes and wrapped { processes: [] } shapes.
+ */
+export declare function parsePm2Jlist(stdout: string): Pm2AppRow[];
+/** True when stdout looked like JSON but did not yield apps (vs truly empty). */
+export declare function pm2JlistLooksBroken(stdout: string, apps: Pm2AppRow[]): boolean;
+export declare function filterPm2Apps(apps: Pm2AppRow[], opts?: {
+    yskOnly?: boolean;
+    q?: string;
+}): Pm2AppRow[];
+/**
+ * Live PM2 snapshot from host (read-only jlist).
+ */
+export declare function collectPm2Snapshot(host: HostExecutor): Promise<Pm2Snapshot>;
+//# sourceMappingURL=pm2-status.d.ts.map

package/dist/hosting/pm2-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm2-status.d.ts","sourceRoot":"","sources":["../../src/hosting/pm2-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAaF;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CA2BvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA+BzD;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAI9E;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,SAAS,EAAE,CAgBb;AAmBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoEjF"}

package/dist/hosting/pm2-status.js

@@ -0,0 +1,188 @@
+/**
+ * Read-only PM2 fleet snapshot for Node/Bun runtime Processes tab.
+ * Uses pm2 jlist (allowed without YSK_EXECUTE). Never invents running apps.
+ */
+import { probePm2 } from './pm2-apply.js';
+function num(v) {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+}
+function str(v) {
+    if (v == null)
+        return '';
+    if (Array.isArray(v))
+        return v.map(String).join(' ');
+    return String(v);
+}
+/**
+ * Normalize one pm2 jlist entry into a table row.
+ */
+export function normalizePm2App(raw) {
+    const env = (raw.pm2_env ?? {});
+    const monit = (raw.monit ?? {});
+    const name = str(raw.name || env.name);
+    const envMap = (env.env ?? {});
+    const port = str(envMap.PORT ?? envMap.port ?? '');
+    return {
+        name,
+        pmId: num(raw.pm_id),
+        pid: num(raw.pid),
+        status: str(env.status || 'unknown'),
+        cpu: num(monit.cpu),
+        memory: num(monit.memory),
+        restarts: num(env.restart_time),
+        unstableRestarts: num(env.unstable_restarts),
+        pmUptime: num(env.pm_uptime),
+        mode: str(env.exec_mode || env.exec_mode_string),
+        instances: num(env.instances),
+        script: str(env.pm_exec_path || env.script || raw.name),
+        cwd: str(env.pm_cwd),
+        interpreter: str(env.exec_interpreter),
+        nodeArgs: str(env.node_args),
+        port,
+        watching: Boolean(env.watch || env.watching),
+        yskManaged: name.startsWith('ysk-'),
+        raw,
+    };
+}
+/**
+ * Parse `pm2 jlist` stdout into rows. Empty / invalid → [].
+ * Tolerates warning prefixes and wrapped { processes: [] } shapes.
+ */
+export function parsePm2Jlist(stdout) {
+    let t = String(stdout || '').trim();
+    if (!t)
+        return [];
+    // Drop leading non-JSON noise (pm2 warnings)
+    const bracket = t.indexOf('[');
+    const brace = t.indexOf('{');
+    if (bracket >= 0 || brace >= 0) {
+        const start = bracket >= 0 && brace >= 0
+            ? Math.min(bracket, brace)
+            : bracket >= 0
+                ? bracket
+                : brace;
+        t = t.slice(start);
+    }
+    try {
+        const data = JSON.parse(t);
+        let arr = [];
+        if (Array.isArray(data))
+            arr = data;
+        else if (data && typeof data === 'object') {
+            const o = data;
+            if (Array.isArray(o.processes))
+                arr = o.processes;
+            else if (Array.isArray(o.apps))
+                arr = o.apps;
+            else if (Array.isArray(o.data))
+                arr = o.data;
+        }
+        return arr
+            .filter((x) => x != null && typeof x === 'object')
+            .map((x) => normalizePm2App(x));
+    }
+    catch {
+        return [];
+    }
+}
+/** True when stdout looked like JSON but did not yield apps (vs truly empty). */
+export function pm2JlistLooksBroken(stdout, apps) {
+    const t = String(stdout || '').trim();
+    if (!t || apps.length > 0)
+        return false;
+    return t.includes('{') || t.includes('[');
+}
+export function filterPm2Apps(apps, opts) {
+    let out = apps;
+    if (opts?.yskOnly)
+        out = out.filter((a) => a.yskManaged);
+    const q = (opts?.q ?? '').trim().toLowerCase();
+    if (q) {
+        out = out.filter((a) => a.name.toLowerCase().includes(q) ||
+            a.script.toLowerCase().includes(q) ||
+            a.cwd.toLowerCase().includes(q) ||
+            a.interpreter.toLowerCase().includes(q) ||
+            a.status.toLowerCase().includes(q) ||
+            String(a.pid ?? '').includes(q));
+    }
+    return out;
+}
+function countByStatus(apps) {
+    let running = 0;
+    let stopped = 0;
+    let errored = 0;
+    for (const a of apps) {
+        const s = a.status.toLowerCase();
+        if (s === 'online' || s === 'launching')
+            running += 1;
+        else if (s === 'stopped' || s === 'stopping')
+            stopped += 1;
+        else if (s === 'errored' || s === 'error')
+            errored += 1;
+    }
+    return { running, stopped, errored };
+}
+/**
+ * Live PM2 snapshot from host (read-only jlist).
+ */
+export async function collectPm2Snapshot(host) {
+    const notes = [];
+    const at = new Date().toISOString();
+    const probe = await probePm2(host);
+    if (!probe.available) {
+        notes.push('pm2 not found on PATH (install Node companion plugin "pm2")');
+        return {
+            available: false,
+            apps: [],
+            running: 0,
+            stopped: 0,
+            errored: 0,
+            at,
+            notes,
+        };
+    }
+    let version;
+    const ver = await host.runCommand(['pm2', '-v'], { timeoutMs: 10_000 });
+    if (ver.exitCode === 0) {
+        version = (ver.stdout || '').trim().split('\n').filter(Boolean).pop();
+    }
+    const jlist = await host.runCommand(['pm2', 'jlist'], { timeoutMs: 20_000 });
+    if (jlist.exitCode !== 0) {
+        notes.push(`pm2 jlist exit=${jlist.exitCode}: ${(jlist.stderr || jlist.stdout || '').slice(0, 200)}`);
+        return {
+            available: true,
+            path: probe.path,
+            version,
+            apps: [],
+            running: 0,
+            stopped: 0,
+            errored: 0,
+            at,
+            notes,
+        };
+    }
+    const rawOut = jlist.stdout || '';
+    const apps = parsePm2Jlist(rawOut);
+    if (!rawOut.trim()) {
+        notes.push('PM2 process list empty under the panel user (projects default to systemd — they will not appear here unless started with pm2)');
+    }
+    else if (apps.length === 0 && pm2JlistLooksBroken(rawOut, apps)) {
+        notes.push(`PM2 list could not be parsed: ${rawOut.replace(/\s+/g, ' ').slice(0, 180)}`);
+    }
+    else if (apps.length === 0) {
+        notes.push('PM2 reports no apps for the panel user. YSK projects usually run under systemd (see project list below when available).');
+    }
+    notes.push('PM2 list is for the panel process user only; other Linux users have separate PM2 homes');
+    const counts = countByStatus(apps);
+    return {
+        available: true,
+        path: probe.path,
+        version,
+        apps,
+        ...counts,
+        at,
+        notes,
+    };
+}
+//# sourceMappingURL=pm2-status.js.map

package/dist/hosting/pm2-status.js.map

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

package/dist/hosting/postfix-bootstrap.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Postfix package can be installed while systemd refuses to start:
+ *   ConditionPathExists=/etc/postfix/main.cf was not met
+ *
+ * Debian "No configuration" debconf (and incomplete configure) leave only
+ * main.cf.proto / master.cf — never a real main.cf.
+ */
+import type { HostExecutor } from '../host/executor.js';
+export type EnsurePostfixMainCfResult = {
+    ok: boolean;
+    created: boolean;
+    path?: string;
+    notes: string[];
+};
+/** True when main.cf is missing (unit will stay inactive even if package+enabled). */
+export declare function postfixMainCfMissing(host: HostExecutor): Promise<boolean>;
+/**
+ * Noninteractive debconf so apt postinst generates a real main.cf.
+ * Prefer Internet Site + hostname mailname over "No configuration".
+ */
+export declare function preseedPostfixDebconf(host: HostExecutor): Promise<string[]>;
+/**
+ * Ensure /etc/postfix/main.cf exists so systemd ConditionPathExists is met.
+ * Safe: only creates when missing; never overwrites an existing main.cf.
+ */
+export declare function ensurePostfixMainCf(host: HostExecutor): Promise<EnsurePostfixMainCfResult>;
+/**
+ * postqueue/postdrop require setgid_group (usually postdrop).
+ * Empty `setgid_group =` yields: fatal: bad string length 0 < 1: setgid_group =
+ */
+export declare function ensurePostfixSetgidGroup(host: HostExecutor): Promise<{
+    ok: boolean;
+    fixed: boolean;
+    notes: string[];
+}>;
+/**
+ * Preflight before start/enable: create main.cf if needed, return notes.
+ */
+export declare function preparePostfixForStart(host: HostExecutor): Promise<{
+    ok: boolean;
+    notes: string[];
+}>;
+/**
+ * Heal queue tooling when Postfix is installed but not ready:
+ * - empty setgid_group
+ * - missing spool dirs (hold/incoming/…) → postsuper/postqueue fail
+ * - master/showq down → "Mail system is down"
+ *
+ * Creates queue tree via `postfix check`, then enables/starts unit.
+ */
+export declare function ensurePostfixRuntimeForQueue(host: HostExecutor): Promise<{
+    ok: boolean;
+    notes: string[];
+    started: boolean;
+}>;
+//# sourceMappingURL=postfix-bootstrap.d.ts.map

package/dist/hosting/postfix-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postfix-bootstrap.d.ts","sourceRoot":"","sources":["../../src/hosting/postfix-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,sFAAsF;AACtF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBjF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAgChG;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+C3D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IACxE,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CAiBD;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA4E7D"}

package/dist/hosting/postfix-bootstrap.js

@@ -0,0 +1,212 @@
+/**
+ * Postfix package can be installed while systemd refuses to start:
+ *   ConditionPathExists=/etc/postfix/main.cf was not met
+ *
+ * Debian "No configuration" debconf (and incomplete configure) leave only
+ * main.cf.proto / master.cf — never a real main.cf.
+ */
+const MAIN_CF = '/etc/postfix/main.cf';
+const MAIN_CF_PROTO = '/etc/postfix/main.cf.proto';
+const MAIN_CF_DEBIAN = '/usr/share/postfix/main.cf.debian';
+/** True when main.cf is missing (unit will stay inactive even if package+enabled). */
+export async function postfixMainCfMissing(host) {
+    try {
+        return !host.pathExists(MAIN_CF);
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Noninteractive debconf so apt postinst generates a real main.cf.
+ * Prefer Internet Site + hostname mailname over "No configuration".
+ */
+export async function preseedPostfixDebconf(host) {
+    const notes = [];
+    const r = await host.runCommand([
+        'bash',
+        '-c',
+        [
+            'set -e',
+            'MAILNAME="$(hostname -f 2>/dev/null || hostname 2>/dev/null || echo localhost)"',
+            'echo "postfix postfix/main_mailer_type select Internet Site" | debconf-set-selections',
+            'echo "postfix postfix/mailname string $MAILNAME" | debconf-set-selections',
+            'echo "postfix postfix/destinations string $MAILNAME, localhost.localdomain, localhost" | debconf-set-selections || true',
+        ].join('\n'),
+    ], { timeoutMs: 15_000 });
+    if (r.exitCode === 0) {
+        notes.push('postfix debconf: Internet Site (will generate main.cf)');
+    }
+    else {
+        notes.push(`postfix debconf preseed soft-fail: ${r.stderr || r.stdout || r.exitCode}`);
+    }
+    return notes;
+}
+/**
+ * Ensure /etc/postfix/main.cf exists so systemd ConditionPathExists is met.
+ * Safe: only creates when missing; never overwrites an existing main.cf.
+ */
+export async function ensurePostfixMainCf(host) {
+    const notes = [];
+    if (host.pathExists(MAIN_CF)) {
+        return { ok: true, created: false, path: MAIN_CF, notes };
+    }
+    let src = '';
+    if (host.pathExists(MAIN_CF_PROTO))
+        src = MAIN_CF_PROTO;
+    else if (host.pathExists(MAIN_CF_DEBIAN))
+        src = MAIN_CF_DEBIAN;
+    if (!src) {
+        notes.push('postfix main.cf missing and no template (main.cf.proto / main.cf.debian) — install postfix package or run dpkg-reconfigure postfix');
+        return { ok: false, created: false, notes };
+    }
+    const r = await host.runCommand(['cp', '-a', src, MAIN_CF], { timeoutMs: 10_000 });
+    if (r.exitCode !== 0) {
+        notes.push(`failed to create main.cf from ${src}: ${r.stderr || r.stdout || r.exitCode}`);
+        return { ok: false, created: false, notes };
+    }
+    // Best-effort permissions / layout (ignore failure)
+    await host.runCommand(['bash', '-c', 'postfix set-permissions 2>/dev/null || true'], {
+        timeoutMs: 15_000,
+    });
+    notes.push(`created ${MAIN_CF} from ${src} (was missing — systemd ConditionPathExists would skip start)`);
+    return { ok: true, created: true, path: MAIN_CF, notes };
+}
+/**
+ * postqueue/postdrop require setgid_group (usually postdrop).
+ * Empty `setgid_group =` yields: fatal: bad string length 0 < 1: setgid_group =
+ */
+export async function ensurePostfixSetgidGroup(host) {
+    const notes = [];
+    if (!host.executeEnabled()) {
+        return {
+            ok: false,
+            fixed: false,
+            notes: ['setgid_group check needs YSK_EXECUTE'],
+        };
+    }
+    const get = await host.runCommand(['bash', '-c', 'postconf -h setgid_group 2>/dev/null || true'], { timeoutMs: 8_000 });
+    const cur = (get.stdout || '').trim();
+    if (cur) {
+        return { ok: true, fixed: false, notes: [`setgid_group=${cur}`] };
+    }
+    // Prefer postdrop group if present
+    const set = await host.runCommand([
+        'bash',
+        '-c',
+        [
+            'set -e',
+            'G=postdrop',
+            'getent group postdrop >/dev/null 2>&1 || G=postfix',
+            'getent group "$G" >/dev/null 2>&1 || G=mail',
+            'postconf -e "setgid_group=$G"',
+            'postconf -h setgid_group',
+        ].join('\n'),
+    ], { timeoutMs: 15_000 });
+    const after = (set.stdout || '').trim();
+    if (set.exitCode === 0 && after) {
+        notes.push(`set setgid_group=${after} (was empty — postqueue needs this)`);
+        // Soft: reload so queue tools pick up conf (ignore failure)
+        await host.runCommand(['bash', '-c', 'postfix reload 2>/dev/null || systemctl reload postfix 2>/dev/null || true'], { timeoutMs: 15_000 });
+        return { ok: true, fixed: true, notes };
+    }
+    notes.push(`could not set setgid_group: ${set.stderr || set.stdout || set.exitCode}`);
+    return { ok: false, fixed: false, notes };
+}
+/**
+ * Preflight before start/enable: create main.cf if needed, return notes.
+ */
+export async function preparePostfixForStart(host) {
+    const notes = [];
+    if (await postfixMainCfMissing(host)) {
+        const r = await ensurePostfixMainCf(host);
+        notes.push(...r.notes);
+        if (!r.ok)
+            return { ok: false, notes };
+    }
+    // Best-effort: empty setgid_group breaks postqueue; do not fail start prep if postconf soft-fails
+    try {
+        const gid = await ensurePostfixSetgidGroup(host);
+        notes.push(...gid.notes);
+    }
+    catch (e) {
+        notes.push(`setgid_group ensure skipped: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return { ok: true, notes };
+}
+/**
+ * Heal queue tooling when Postfix is installed but not ready:
+ * - empty setgid_group
+ * - missing spool dirs (hold/incoming/…) → postsuper/postqueue fail
+ * - master/showq down → "Mail system is down"
+ *
+ * Creates queue tree via `postfix check`, then enables/starts unit.
+ */
+export async function ensurePostfixRuntimeForQueue(host) {
+    const notes = [];
+    if (!host.executeEnabled()) {
+        return {
+            ok: false,
+            started: false,
+            notes: ['postfix queue heal needs YSK_EXECUTE'],
+        };
+    }
+    try {
+        const main = await ensurePostfixMainCf(host);
+        notes.push(...main.notes);
+        // Continue even if main.cf missing — start may still clarify failure notes
+    }
+    catch (e) {
+        notes.push(`main.cf ensure: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    try {
+        const gid = await ensurePostfixSetgidGroup(host);
+        notes.push(...gid.notes);
+    }
+    catch (e) {
+        notes.push(`setgid_group: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // Create missing queue subdirs (hold, deferred, …) and fix ownership
+    const check = await host.runCommand([
+        'bash',
+        '-c',
+        [
+            'set +e',
+            'QD="$(postconf -h queue_directory 2>/dev/null || echo /var/spool/postfix)"',
+            'QD="${QD:-/var/spool/postfix}"',
+            'mkdir -p "$QD"',
+            'for d in active bounce corrupt defer deferred flush hold incoming maildrop private public saved trace; do',
+            '  mkdir -p "$QD/$d"',
+            'done',
+            'postfix set-permissions 2>/dev/null || true',
+            'postfix check 2>&1 | tail -30',
+            'exit 0',
+        ].join('\n'),
+    ], { timeoutMs: 45_000 });
+    const checkOut = (check.stdout || check.stderr || '').trim();
+    if (checkOut)
+        notes.push(`postfix check: ${checkOut.slice(0, 240)}`);
+    else
+        notes.push('postfix spool dirs ensured');
+    let started = false;
+    const st = await host.runCommand([
+        'bash',
+        '-c',
+        [
+            'set +e',
+            'systemctl enable postfix 2>/dev/null || true',
+            'systemctl start postfix 2>/dev/null || postfix start 2>/dev/null || true',
+            'systemctl is-active postfix 2>/dev/null || echo inactive',
+        ].join('\n'),
+    ], { timeoutMs: 45_000 });
+    const active = (st.stdout || st.stderr || '').trim().split('\n').pop() || '';
+    if (active === 'active' || active === 'running') {
+        started = true;
+        notes.push('postfix service active');
+    }
+    else {
+        notes.push(`postfix service state: ${active || 'unknown'}`);
+    }
+    return { ok: true, started, notes };
+}
+//# sourceMappingURL=postfix-bootstrap.js.map

package/dist/hosting/postfix-bootstrap.js.map

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

package/dist/hosting/postgres-provision.d.ts

@@ -0,0 +1,48 @@
+/**
+ * PostgreSQL provision via psql when available.
+ * Never reports ok=true for skipped system mutations.
+ */
+import type { HostExecutor } from '../host/executor.js';
+export interface PostgresProvisionResult {
+    ok: boolean;
+    executed: boolean;
+    /** true when plan-only (no --execute) */
+    dryRun?: boolean;
+    blocked?: boolean;
+    requiresExecute: boolean;
+    psqlClient: boolean;
+    reachable: boolean;
+    sql: string[];
+    connectionHint: Record<string, string | number>;
+    notes: string[];
+    commandResults: Array<{
+        argv: string[];
+        exitCode: number;
+        stderr: string;
+    }>;
+}
+/**
+ * Render SQL for role + database (password embedded only when executing).
+ */
+export declare function renderPostgresProvisionSql(input: {
+    dbName: string;
+    username: string;
+    password: string;
+}): string[];
+/**
+ * Provision PG database + role.
+ * Without EXECUTE or psql: ok=false + SQL plan.
+ * With EXECUTE + psql: runs via `psql -v ON_ERROR_STOP=1 -c` / multi-step.
+ */
+export declare function provisionPostgresDatabase(input: {
+    dbName: string;
+    username: string;
+    password: string;
+    host?: string;
+    port?: number;
+    hostExec: HostExecutor;
+    execute?: boolean;
+    /** Superuser connection db (default postgres) */
+    adminDb?: string;
+}): Promise<PostgresProvisionResult>;
+//# sourceMappingURL=postgres-provision.d.ts.map

package/dist/hosting/postgres-provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-provision.d.ts","sourceRoot":"","sources":["../../src/hosting/postgres-provision.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAQD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CAUX;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0InC"}