ysk-server-core 1.0.0

package/dist/hosting/sql-engine-health/diagnose.js

@@ -0,0 +1,268 @@
+/**
+ * Diagnose MySQL/MariaDB host state → findings + repair plan.
+ * Mass-market: one report for install/start/switch failures, not ad-hoc if/else per bug.
+ */
+import { readMysqlFrozen, isMysqlDatadirEmptyOrUninitialized, } from '../sql-engine-switch/mysql-frozen.js';
+import { HostSoftwareProbe } from '../software-probe/index.js';
+function unitName(flavor) {
+    return flavor === 'mysql' ? 'mysql' : 'mariadb';
+}
+function serverId(flavor) {
+    return flavor === 'mysql' ? 'mysql-server' : 'mariadb-server';
+}
+async function readActive(host, unit) {
+    const r = await host.runCommand(['systemctl', 'is-active', unit], { timeoutMs: 5_000 });
+    return (r.stdout || r.stderr || 'unknown').trim().split(/\s+/)[0] || 'unknown';
+}
+async function readConfigTarget(host) {
+    const r = await host.runCommand(['bash', '-c', 'readlink -f /etc/mysql/my.cnf 2>/dev/null || readlink -f /etc/alternatives/my.cnf 2>/dev/null || echo unknown'], { timeoutMs: 5_000 });
+    return (r.stdout || '').trim() || 'unknown';
+}
+async function hasForeignPluginCnf(host, flavor) {
+    // MySQL must not load MariaDB provider_*; MariaDB rarely loads mysql-only snippets
+    const script = flavor === 'mysql'
+        ? `
+hits=""
+for d in /etc/mysql/mariadb.conf.d /etc/mysql/conf.d; do
+  [ -d "$d" ] || continue
+  for f in "$d"/*provider* "$d"/*mariadb*; do
+    [ -e "$f" ] || continue
+    hits="$hits $f"
+  done
+done
+# my.cnf points at mariadb
+cur=$(readlink -f /etc/mysql/my.cnf 2>/dev/null || true)
+case "$cur" in *mariadb*) hits="$hits my.cnf->$cur" ;; esac
+if [ -n "$hits" ]; then echo "YES|$hits"; else echo "NO|"; fi
+`
+        : `
+hits=""
+cur=$(readlink -f /etc/mysql/my.cnf 2>/dev/null || true)
+case "$cur" in *mysql.cnf|*mysql.conf*) hits="$hits my.cnf->$cur" ;; esac
+if [ -n "$hits" ]; then echo "YES|$hits"; else echo "NO|"; fi
+`;
+    const r = await host.runCommand(['bash', '-c', script], { timeoutMs: 8_000 });
+    const line = (r.stdout || '').trim();
+    if (line.startsWith('YES|')) {
+        return { yes: true, evidence: line.slice(4).trim().slice(0, 200) };
+    }
+    return { yes: false, evidence: '' };
+}
+async function port3306Busy(host) {
+    const r = await host.runCommand([
+        'bash',
+        '-c',
+        `ss -tlnp 2>/dev/null | grep -E ':3306\\b' | head -2 || netstat -tlnp 2>/dev/null | grep 3306 | head -2 || true`,
+    ], { timeoutMs: 5_000 });
+    const line = (r.stdout || '').trim();
+    if (!line)
+        return { yes: false, evidence: '' };
+    // if our unit is active, port busy is expected — caller filters
+    return { yes: true, evidence: line.slice(0, 200) };
+}
+/** Build ordered repair plan from findings (deterministic, flavor-agnostic pipeline). */
+export function planRepairFromFindings(findings) {
+    const ids = new Set(findings.map((f) => f.id));
+    const plan = [];
+    const need = ids.has('unit_not_active') ||
+        ids.has('unit_failed') ||
+        ids.has('frozen_marker') ||
+        ids.has('datadir_uninitialized') ||
+        ids.has('config_flavor_mismatch') ||
+        ids.has('residual_foreign_plugins');
+    if (!need)
+        return plan;
+    const because = (candidates) => candidates.filter((c) => ids.has(c));
+    plan.push({
+        id: 'stop_unit',
+        because: because([
+            'unit_failed',
+            'unit_not_active',
+            'frozen_marker',
+            'datadir_uninitialized',
+            'config_flavor_mismatch',
+            'residual_foreign_plugins',
+        ]),
+        requiresConfirm: true,
+        messageKey: 'sqlEngineHealth.action.stop_unit',
+    });
+    if (ids.has('frozen_marker')) {
+        plan.push({
+            id: 'clear_frozen',
+            because: ['frozen_marker'],
+            requiresConfirm: true,
+            messageKey: 'sqlEngineHealth.action.clear_frozen',
+        });
+    }
+    if (ids.has('config_flavor_mismatch') || ids.has('residual_foreign_plugins')) {
+        plan.push({
+            id: 'sanitize_config',
+            because: because(['config_flavor_mismatch', 'residual_foreign_plugins']),
+            requiresConfirm: true,
+            messageKey: 'sqlEngineHealth.action.sanitize_config',
+        });
+    }
+    if (ids.has('datadir_uninitialized')) {
+        plan.push({
+            id: 'init_datadir',
+            because: ['datadir_uninitialized'],
+            requiresConfirm: true,
+            messageKey: 'sqlEngineHealth.action.init_datadir',
+        });
+    }
+    plan.push({
+        id: 'reset_failed',
+        because: because(['unit_failed', 'unit_not_active', 'frozen_marker']),
+        requiresConfirm: true,
+        messageKey: 'sqlEngineHealth.action.reset_failed',
+    });
+    plan.push({
+        id: 'enable_unit',
+        because: because(['unit_failed', 'unit_not_active']),
+        requiresConfirm: true,
+        messageKey: 'sqlEngineHealth.action.enable_unit',
+    });
+    plan.push({
+        id: 'start_unit',
+        because: because(['unit_failed', 'unit_not_active', 'frozen_marker', 'datadir_uninitialized']),
+        requiresConfirm: true,
+        messageKey: 'sqlEngineHealth.action.start_unit',
+    });
+    plan.push({
+        id: 'verify_active',
+        because: because(['unit_failed', 'unit_not_active']),
+        requiresConfirm: false,
+        messageKey: 'sqlEngineHealth.action.verify_active',
+    });
+    return plan;
+}
+export async function diagnoseSqlEngine(host, flavor) {
+    const unit = unitName(flavor);
+    const probe = new HostSoftwareProbe(host);
+    const server = await probe.presence(serverId(flavor));
+    const client = await probe.presence('mysql-client');
+    const active = server.installed ? await readActive(host, unit) : 'not_installed';
+    const findings = [];
+    if (!server.installed) {
+        findings.push({
+            id: 'package_missing',
+            severity: 'blocker',
+            messageKey: 'sqlEngineHealth.finding.package_missing',
+            params: { flavor },
+        });
+    }
+    if (!client.installed) {
+        findings.push({
+            id: 'client_missing',
+            severity: 'warn',
+            messageKey: 'sqlEngineHealth.finding.client_missing',
+        });
+    }
+    let frozen = false;
+    let frozenMode;
+    let datadirUninitialized = false;
+    let configPointsTo;
+    if (server.installed) {
+        const fr = await readMysqlFrozen(host);
+        frozen = fr.frozen;
+        frozenMode = fr.modeHint;
+        if (fr.frozen) {
+            findings.push({
+                id: 'frozen_marker',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.frozen_marker',
+                params: { mode: fr.modeHint || 'frozen' },
+                evidence: fr.content.slice(0, 200),
+            });
+        }
+        datadirUninitialized = await isMysqlDatadirEmptyOrUninitialized(host);
+        if (datadirUninitialized) {
+            findings.push({
+                id: 'datadir_uninitialized',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.datadir_uninitialized',
+            });
+        }
+        configPointsTo = await readConfigTarget(host);
+        const expectsMysql = flavor === 'mysql';
+        const pointsMaria = /mariadb/i.test(configPointsTo);
+        const pointsMysql = /mysql\.cnf|mysql\.conf/i.test(configPointsTo);
+        if (expectsMysql && pointsMaria) {
+            findings.push({
+                id: 'config_flavor_mismatch',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.config_flavor_mismatch',
+                params: { flavor, path: configPointsTo },
+                evidence: configPointsTo,
+            });
+        }
+        if (!expectsMysql && pointsMysql && !pointsMaria) {
+            findings.push({
+                id: 'config_flavor_mismatch',
+                severity: 'warn',
+                messageKey: 'sqlEngineHealth.finding.config_flavor_mismatch',
+                params: { flavor, path: configPointsTo },
+                evidence: configPointsTo,
+            });
+        }
+        const foreign = await hasForeignPluginCnf(host, flavor);
+        if (foreign.yes) {
+            findings.push({
+                id: 'residual_foreign_plugins',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.residual_foreign_plugins',
+                evidence: foreign.evidence,
+            });
+        }
+        if (active === 'failed') {
+            findings.push({
+                id: 'unit_failed',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.unit_failed',
+                params: { unit },
+            });
+        }
+        else if (active !== 'active' && active !== 'not_installed') {
+            findings.push({
+                id: 'unit_not_active',
+                severity: 'error',
+                messageKey: 'sqlEngineHealth.finding.unit_not_active',
+                params: { unit, active },
+            });
+        }
+        if (active !== 'active') {
+            const port = await port3306Busy(host);
+            if (port.yes) {
+                findings.push({
+                    id: 'port_conflict',
+                    severity: 'warn',
+                    messageKey: 'sqlEngineHealth.finding.port_conflict',
+                    evidence: port.evidence,
+                });
+            }
+        }
+    }
+    const repairPlan = planRepairFromFindings(findings);
+    const healthy = server.installed &&
+        active === 'active' &&
+        !frozen &&
+        !findings.some((f) => f.severity === 'error' || f.severity === 'blocker');
+    return {
+        flavor,
+        unit,
+        healthy,
+        serverInstalled: server.installed,
+        clientInstalled: client.installed,
+        active,
+        findings,
+        repairPlan,
+        requiresConfirm: repairPlan.some((a) => a.requiresConfirm),
+        frozen,
+        frozenMode,
+        datadirUninitialized,
+        configPointsTo,
+        executeEnabled: host.executeEnabled(),
+        isRoot: host.isRoot(),
+    };
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/hosting/sql-engine-health/diagnose.js.map

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

package/dist/hosting/sql-engine-health/execute.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Execute a SQL engine repair plan produced by diagnose + planRepairFromFindings.
+ */
+import type { HostExecutor } from '../../host/executor.js';
+import type { SqlEngineFlavor, SqlEngineHealthReport, SqlRepairResult } from './types.js';
+export declare function executeSqlEngineRepair(input: {
+    host: HostExecutor;
+    flavor: SqlEngineFlavor;
+    /** Must be true to run destructive steps */
+    confirm: boolean;
+    /** Optional precomputed report */
+    report?: SqlEngineHealthReport;
+}): Promise<SqlRepairResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/hosting/sql-engine-health/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAS3D,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAErB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,GAAG,OAAO,CAAC,eAAe,CAAC,CA0E3B"}

package/dist/hosting/sql-engine-health/execute.js

@@ -0,0 +1,130 @@
+/**
+ * Execute a SQL engine repair plan produced by diagnose + planRepairFromFindings.
+ */
+import { tl } from 'ysk-server-shared';
+import { panelBlockMessage } from '../system-apply.js';
+import { clearMysqlFrozen, sanitizeSqlConfigForFlavor, initializeMysqlDatadirIfEmpty, waitUnitActiveHelper, } from './actions.js';
+import { diagnoseSqlEngine } from './diagnose.js';
+export async function executeSqlEngineRepair(input) {
+    const host = input.host;
+    if (!host.executeEnabled() || !host.isRoot()) {
+        const reason = !host.executeEnabled() ? 'no_execute' : 'no_root';
+        const blockMessage = panelBlockMessage(reason);
+        return { ok: false, blocked: true, blockMessage, notes: [blockMessage], steps: [] };
+    }
+    const report = input.report ?? (await diagnoseSqlEngine(host, input.flavor));
+    if (report.healthy && report.repairPlan.length === 0) {
+        return {
+            ok: true,
+            notes: [tl('sqlEngineHealth.note.alreadyHealthy')],
+            steps: [],
+            healthAfter: report,
+        };
+    }
+    if (report.requiresConfirm && input.confirm !== true) {
+        return {
+            ok: false,
+            code: 'needs_confirm',
+            notes: [
+                tl('sqlEngineHealth.note.needsConfirm', {
+                    count: report.repairPlan.length,
+                    findings: report.findings.map((f) => f.id).join(','),
+                }),
+            ],
+            steps: [],
+            healthAfter: report,
+        };
+    }
+    if (report.findings.some((f) => f.id === 'package_missing')) {
+        return {
+            ok: false,
+            notes: [tl('sqlEngineHealth.note.installPackageFirst', { flavor: input.flavor })],
+            steps: [],
+            healthAfter: report,
+        };
+    }
+    const notes = [];
+    const steps = [];
+    const unit = report.unit;
+    // Surface findings as notes (localized keys)
+    for (const f of report.findings) {
+        notes.push(tl(f.messageKey, f.params));
+    }
+    for (const action of report.repairPlan) {
+        const step = await runAction(host, input.flavor, unit, action);
+        steps.push(step);
+        if (step.status === 'failed') {
+            notes.push(tl('sqlEngineHealth.note.stepFailed', {
+                action: action.id,
+                detail: step.detail || '',
+            }));
+            const healthAfter = await diagnoseSqlEngine(host, input.flavor);
+            return { ok: false, notes, steps, healthAfter };
+        }
+    }
+    const healthAfter = await diagnoseSqlEngine(host, input.flavor);
+    const ok = healthAfter.healthy && healthAfter.active === 'active';
+    notes.push(ok
+        ? tl('sqlEngineHealth.note.repairOk', { unit })
+        : tl('sqlEngineHealth.note.repairIncomplete', { active: healthAfter.active }));
+    return { ok, notes, steps, healthAfter };
+}
+async function runAction(host, flavor, unit, action) {
+    switch (action.id) {
+        case 'stop_unit': {
+            await host.runCommand(['systemctl', 'stop', unit], { timeoutMs: 60_000 });
+            return { id: action.id, status: 'ok' };
+        }
+        case 'clear_frozen': {
+            const r = await clearMysqlFrozen(host);
+            return {
+                id: action.id,
+                status: r.ok ? 'ok' : 'failed',
+                detail: r.notes.join('; '),
+            };
+        }
+        case 'sanitize_config': {
+            const r = await sanitizeSqlConfigForFlavor(host, flavor);
+            return {
+                id: action.id,
+                status: r.ok ? 'ok' : 'failed',
+                detail: r.notes.join('; '),
+            };
+        }
+        case 'init_datadir': {
+            const r = await initializeMysqlDatadirIfEmpty(host, flavor);
+            return {
+                id: action.id,
+                status: r.ok ? (r.initialized ? 'ok' : 'skipped') : 'failed',
+                detail: r.notes.join('; '),
+            };
+        }
+        case 'reset_failed': {
+            await host.runCommand(['systemctl', 'reset-failed', unit], { timeoutMs: 10_000 });
+            return { id: action.id, status: 'ok' };
+        }
+        case 'enable_unit': {
+            await host.runCommand(['systemctl', 'enable', unit], { timeoutMs: 60_000 });
+            return { id: action.id, status: 'ok' };
+        }
+        case 'start_unit': {
+            const r = await host.runCommand(['systemctl', 'start', unit], { timeoutMs: 120_000 });
+            return {
+                id: action.id,
+                status: r.exitCode === 0 ? 'ok' : 'failed',
+                detail: r.exitCode === 0 ? undefined : (r.stderr || r.stdout).slice(0, 300),
+            };
+        }
+        case 'verify_active': {
+            const ok = await waitUnitActiveHelper(host, unit, 90_000);
+            return {
+                id: action.id,
+                status: ok ? 'ok' : 'failed',
+                detail: ok ? 'active' : 'not active',
+            };
+        }
+        default:
+            return { id: action.id, status: 'skipped', detail: 'unknown action' };
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/hosting/sql-engine-health/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAO5C;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,CAAC,EAAE,CAAC,qCAAqC,CAAC,CAAC;YAClD,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE;gBACL,EAAE,CAAC,mCAAmC,EAAE;oBACtC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;oBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;iBACrD,CAAC;aACH;YACD,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,iBAAiB,CAAC,EAAE,CAAC;QAC5D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,CAAC,EAAE,CAAC,0CAA0C,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACjF,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,6CAA6C;IAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,MAAqD,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,EAAE,CAAC,iCAAiC,EAAE;gBACpC,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;aAC1B,CAAC,CACH,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC;IAClE,KAAK,CAAC,IAAI,CACR,EAAE;QACA,CAAC,CAAC,EAAE,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC,CAAC,EAAE,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAChF,CAAC;IACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,IAAkB,EAClB,MAAuB,EACvB,IAAY,EACZ,MAAuB;IAEvB,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;gBAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3B,CAAC;QACJ,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,CAAC,GAAG,MAAM,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;gBAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3B,CAAC;QACJ,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,MAAM,6BAA6B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ;gBAC5D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3B,CAAC;QACJ,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAClF,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACtF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;gBAC1C,MAAM,EAAE,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aAC5E,CAAC;QACJ,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1D,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;gBAC5B,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY;aACrC,CAAC;QACJ,CAAC;QACD;YACE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/hosting/sql-engine-health/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './diagnose.js';
+export * from './execute.js';
+/** Compat helpers (distinct names — switch module already owns recover/unfreeze aliases). */
+export { executeSqlEngineRepairAsRecover, unfreezeViaHealth, } from './compat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hosting/sql-engine-health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,6FAA6F;AAC7F,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/hosting/sql-engine-health/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './diagnose.js';
+export * from './execute.js';
+/** Compat helpers (distinct names — switch module already owns recover/unfreeze aliases). */
+export { executeSqlEngineRepairAsRecover, unfreezeViaHealth, } from './compat.js';
+//# sourceMappingURL=index.js.map

package/dist/hosting/sql-engine-health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,6FAA6F;AAC7F,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/hosting/sql-engine-health/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Generic SQL server health model (MySQL / MariaDB).
+ * Not a one-off for FROZEN — catalog of findings → repair plan → execute.
+ */
+export type SqlEngineFlavor = 'mysql' | 'mariadb';
+/** Machine-readable finding codes (stable for UI/i18n). */
+export type SqlFindingId = 'package_missing' | 'unit_not_active' | 'unit_failed' | 'frozen_marker' | 'datadir_uninitialized' | 'config_flavor_mismatch' | 'residual_foreign_plugins' | 'port_conflict' | 'client_missing';
+export type FindingSeverity = 'info' | 'warn' | 'error' | 'blocker';
+export type SqlFinding = {
+    id: SqlFindingId;
+    severity: FindingSeverity;
+    /** sqlEngineHealth.finding.<id> */
+    messageKey: string;
+    params?: Record<string, string | number | boolean>;
+    evidence?: string;
+};
+/** Ordered repair actions derived from findings (generic pipeline). */
+export type SqlRepairActionId = 'stop_unit' | 'clear_frozen' | 'sanitize_config' | 'init_datadir' | 'reset_failed' | 'enable_unit' | 'start_unit' | 'verify_active';
+export type SqlRepairAction = {
+    id: SqlRepairActionId;
+    /** findings that caused this action to be scheduled */
+    because: SqlFindingId[];
+    /**
+     * true = needs explicit operator confirm (destructive / data-touching).
+     * Pipeline as a whole requires confirm if any action does.
+     */
+    requiresConfirm: boolean;
+    /** sqlEngineHealth.action.<id> */
+    messageKey: string;
+};
+export type SqlEngineHealthReport = {
+    flavor: SqlEngineFlavor;
+    unit: string;
+    healthy: boolean;
+    serverInstalled: boolean;
+    clientInstalled: boolean;
+    active: string;
+    findings: SqlFinding[];
+    repairPlan: SqlRepairAction[];
+    /** true if any repair action needs confirm */
+    requiresConfirm: boolean;
+    frozen: boolean;
+    frozenMode?: string;
+    datadirUninitialized: boolean;
+    configPointsTo?: string;
+    executeEnabled: boolean;
+    isRoot: boolean;
+};
+export type SqlRepairStepResult = {
+    id: SqlRepairActionId;
+    status: 'ok' | 'failed' | 'skipped';
+    detail?: string;
+};
+export type SqlRepairResult = {
+    ok: boolean;
+    blocked?: boolean;
+    blockMessage?: string;
+    code?: 'needs_confirm' | string;
+    notes: string[];
+    steps: SqlRepairStepResult[];
+    healthAfter?: SqlEngineHealthReport;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/hosting/sql-engine-health/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,uBAAuB,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,iBAAiB,CAAC;IACtB,uDAAuD;IACvD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC"}

package/dist/hosting/sql-engine-health/types.js

@@ -0,0 +1,6 @@
+/**
+ * Generic SQL server health model (MySQL / MariaDB).
+ * Not a one-off for FROZEN — catalog of findings → repair plan → execute.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hosting/sql-engine-health/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hosting/sql-engine-health/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/hosting/sql-engine-switch/grants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Best-effort export of SHOW GRANTS for non-system users (logical migration).
+ */
+import type { HostExecutor } from '../../host/executor.js';
+export declare function exportUserGrants(host: HostExecutor, flavor: 'mysql' | 'mariadb', rootPassword?: string): Promise<{
+    ok: boolean;
+    sql: string;
+    notes: string[];
+}>;
+//# sourceMappingURL=grants.d.ts.map

package/dist/hosting/sql-engine-switch/grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../../../src/hosting/sql-engine-switch/grants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAU3D,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqDxD"}

package/dist/hosting/sql-engine-switch/grants.js

@@ -0,0 +1,61 @@
+/**
+ * Best-effort export of SHOW GRANTS for non-system users (logical migration).
+ */
+const SKIP_USERS = new Set([
+    'mysql.sys',
+    'mysql.session',
+    'mysql.infoschema',
+    'mariadb.sys',
+    'debian-sys-maint',
+]);
+export async function exportUserGrants(host, flavor, rootPassword) {
+    const { sqlPasswordEnvPrefix } = await import('./sql-auth.js');
+    const env = sqlPasswordEnvPrefix(rootPassword);
+    const client = flavor === 'mariadb' ? 'mariadb' : 'mysql';
+    const list = await host.runCommand([
+        'bash',
+        '-c',
+        `${env}${client} -N -e "SELECT user,host FROM mysql.user" 2>/dev/null || ${env}mysql -N -e "SELECT user,host FROM mysql.user" 2>/dev/null || true`,
+    ], { timeoutMs: 30_000 });
+    const lines = list.stdout
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean);
+    const parts = [
+        '-- YSK sql-engine-switch: grants (best-effort)',
+        'FLUSH PRIVILEGES;',
+    ];
+    let count = 0;
+    for (const line of lines) {
+        const cols = line.split(/\t/);
+        const user = cols[0]?.trim() ?? '';
+        const hostPart = cols[1]?.trim() ?? '%';
+        if (!user || SKIP_USERS.has(user) || user.startsWith('mysql.'))
+            continue;
+        if (user === 'root' && (hostPart === 'localhost' || hostPart === '127.0.0.1')) {
+            // keep root grants optional — unix_socket often differs; still export
+        }
+        const uEsc = user.replace(/'/g, "\\'");
+        const hEsc = hostPart.replace(/'/g, "\\'");
+        const g = await host.runCommand([
+            'bash',
+            '-c',
+            `${env}${client} -N -e "SHOW GRANTS FOR '${uEsc}'@'${hEsc}'" 2>/dev/null || ${env}mysql -N -e "SHOW GRANTS FOR '${uEsc}'@'${hEsc}'" 2>/dev/null || true`,
+        ], { timeoutMs: 10_000 });
+        for (const gl of g.stdout.split('\n')) {
+            const t = gl.trim();
+            if (!t)
+                continue;
+            // SHOW GRANTS returns GRANT ... — append semicolon if missing
+            parts.push(t.endsWith(';') ? t : `${t};`);
+            count++;
+        }
+    }
+    parts.push('FLUSH PRIVILEGES;');
+    return {
+        ok: true,
+        sql: parts.join('\n') + '\n',
+        notes: count ? [`exported ${count} grant line(s)`] : ['no application grants found'],
+    };
+}
+//# sourceMappingURL=grants.js.map

package/dist/hosting/sql-engine-switch/grants.js.map

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

package/dist/hosting/sql-engine-switch/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './sql-auth.js';
+export * from './mysql-frozen.js';
+export * from './preview.js';
+export * from './grants.js';
+export * from './migrate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hosting/sql-engine-switch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hosting/sql-engine-switch/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}