kitowall 7.5.0 → 7.9.0

package/README.md

@@ -76,6 +76,25 @@ Dependencias del stack principal, según la función usada:
 
 La distribución recomendada de la UI es la `AppImage`.
 
+### Paso previo obligatorio
+Antes de abrir `Kitowall`, el host debe tener:
+- `nodejs`
+- `npm`
+- `kitowall` CLI instalado para el usuario actual
+
+Comando recomendado:
+```bash
+npm i -g --prefix ~/.local kitowall@latest
+```
+
+Verificación rápida:
+```bash
+command -v node
+command -v npm
+command -v kitowall
+kitowall --version
+```
+
 ### Importante
 No ejecutes la AppImage con `sudo`.
 
@@ -96,9 +115,10 @@ Razón:
 
 ### Flujo recomendado
 1. Descarga la última `AppImage` desde GitHub Releases.
-2. Dale permisos de ejecución.
-3. Ábrela como usuario normal.
-4. Usa el instalador de dependencias desde la UI.
+2. Asegúrate de tener `nodejs`, `npm` y `kitowall` CLI instalados.
+3. Dale permisos de ejecución.
+4. Ábrela como usuario normal.
+5. Usa el instalador de dependencias desde la UI.
 
 ## Instalación de dependencias del host
 
@@ -148,6 +168,13 @@ Eso ejecuta:
 ### Nota
 El script puede necesitar privilegios para instalar paquetes del sistema. La forma recomendada para usuarios finales sigue siendo la UI con `pkexec`.
 
+### Si el CLI del host está desactualizado
+Si la UI indica que el `kitowall` del host no soporta un comando nuevo, actualízalo con:
+
+```bash
+npm i -g --prefix ~/.local kitowall@latest
+```
+
 ## Inicialización
 
 Después del bootstrap, inicializa el stack:
@@ -361,6 +388,25 @@ Common dependencies depending on enabled features:
 
 The recommended desktop distribution for the UI is the `AppImage`.
 
+### Required First Step
+Before opening `Kitowall`, the host must already have:
+- `nodejs`
+- `npm`
+- the `kitowall` CLI installed for the current user
+
+Recommended command:
+```bash
+npm i -g --prefix ~/.local kitowall@latest
+```
+
+Quick verification:
+```bash
+command -v node
+command -v npm
+command -v kitowall
+kitowall --version
+```
+
 ### Important
 Do not run the AppImage with `sudo`.
 
@@ -381,9 +427,10 @@ Reason:
 
 ### Recommended Flow
 1. Download the latest `AppImage` from GitHub Releases.
-2. Make it executable.
-3. Launch it as a normal user.
-4. Use the dependency installer from the UI.
+2. Make sure `nodejs`, `npm`, and the `kitowall` CLI are installed.
+3. Make it executable.
+4. Launch it as a normal user.
+5. Use the dependency installer from the UI.
 
 ## Host Dependency Installation
 
@@ -437,6 +484,13 @@ That handles:
 ### Note
 The script may need privileges for system package installation. For end users, the recommended path remains the UI flow using `pkexec`.
 
+### If the host CLI is outdated
+If the UI reports that the host `kitowall` does not support a newer command, update it with:
+
+```bash
+npm i -g --prefix ~/.local kitowall@latest
+```
+
 ## Initialization
 
 After bootstrap, initialize the stack:

package/dist/cli.js

@@ -43,6 +43,7 @@ const systemd_1 = require("./core/systemd");
 const init_1 = require("./core/init");
 const watch_1 = require("./core/watch");
 const doctor_1 = require("./core/doctor");
+const setup_1 = require("./core/setup");
 const cache_1 = require("./core/cache");
 const favorites_1 = require("./core/favorites");
 const history_1 = require("./core/history");
@@ -73,6 +74,9 @@ function printUsage() {
     console.log(`kitowall <command> [options]
 
 Commands:
+  version | --version | -v                  Show CLI version
+
+Core:
   outputs                                  List outputs (Wayland monitors)
   next [--pack <name>] [--namespace <ns>]     Apply next wallpapers (respects mode unless --force)
   status                                   Show current state in JSON
@@ -119,6 +123,8 @@ Commands:
   logs [--limit <n>] [--source <name>] [--pack <name>] [--level <info|warn|error>] [--q <text>]
                                          Show system logs (requests/downloads/errors)
   logs clear                             Clear system logs
+
+Wallpaper Engine:
   we config set-api-key <key>            Save Steam Web API key (~/.config/kitowall/we.json)
   we config get-steam-roots              Show configured manual Steam roots
   we config set-steam-roots <a,b,c>      Save manual Steam roots (steam root or workshop/content/431960)
@@ -141,6 +147,8 @@ Commands:
                                          Apply wallpapers in batch by monitor map
   we stop [--monitor <name> | --all]     Stop livewallpaper instances and restore previous services
   we coexist enter|exit|status           Temporarily stop/restore wallpaper rotation services
+
+Live Wallpapers:
   live init                              Initialize LiveWallpapers storage/index
   live list [--favorites] [--json]       List downloaded LiveWallpapers from local index
   live browse [--page <n>] [--quality 4k|all] [--provider moewalls|motionbgs|all]
@@ -165,19 +173,32 @@ Commands:
   live config runner [--bin-name <name>]
   live config apply-defaults [--video-fps <n>] [--video-speed <n>] [--hwaccel auto|nvdec|vaapi|none]
                              [--quality low|medium|high|ultra] [--pause-on-steam-game true|false] [--steam-poll-ms <n>]
+  live view                               Show consolidated livewallpaper runtime/config data
   live doctor [--fix]
-  check [--namespace <ns>] [--json]        Quick system check (no changes)
 
+System / Host:
+  check [--namespace <ns>] [--json]        Quick system check (no changes)
   init [--namespace <ns>] [--apply] [--force]       Setup kitowall (install daemon + watcher + next.service), validate deps
   watch [--debounce <ms>]                  Watch Hyprland monitor hotplug events and apply wallpapers
   doctor [--namespace <ns>]
   health [--namespace <ns>]
-
   install-systemd [--every <dur>]          Install + enable systemd user timer (timer only)
   uninstall-systemd                        Disable systemd timer
   systemd-status                           Show systemd timer status
   rotate-now [--pack <name>]               Apply next wallpapers ignoring manual mode (for timers)
   mode <manual|rotate>                     Set mode persistently in state.json
+
+Host Setup:
+  host-setup check dependency <id> [--json]
+                                          Check one host dependency
+  host-setup check service <id> [--namespace <ns>] [--json]
+                                          Check one host service/config item
+  host-setup list [--namespace <ns>] [--json]
+                                          List all host dependencies and services with status
+  host-setup versions [--json]
+                                          Show local/latest versions for kitowall, kitsune, and rendercore
+  host-setup install <id> [--namespace <ns>]
+                                          Install, reinstall, or repair one host item
 Examples:
   kitowall init --namespace kitowall --apply
   kitowall install-systemd --every 5m
@@ -349,6 +370,36 @@ async function main() {
         process.exitCode = report.ok ? 0 : 2;
         return;
     }
+    if (cmd === 'host-setup') {
+        const action = cleanOpt(args[1] ?? null);
+        const target = cleanOpt(args[2] ?? null);
+        const id = cleanOpt(args[3] ?? null);
+        const namespace = cleanOpt(getOptionValue(args, '--namespace')) ?? 'kitowall';
+        if (action === 'check' && target === 'dependency' && id) {
+            console.log(JSON.stringify(await (0, setup_1.checkSetupDependency)(id), null, 2));
+            return;
+        }
+        if (action === 'check' && target === 'service' && id) {
+            console.log(JSON.stringify(await (0, setup_1.checkSetupService)(id, namespace), null, 2));
+            return;
+        }
+        if (action === 'list') {
+            console.log(JSON.stringify(await (0, setup_1.listSetupStatus)(namespace), null, 2));
+            return;
+        }
+        if (action === 'versions') {
+            console.log(JSON.stringify(await (0, setup_1.listSetupVersions)(), null, 2));
+            return;
+        }
+        if (action === 'install' && target) {
+            const result = await (0, setup_1.installSetupItem)(target, namespace);
+            if (result.logs.trim())
+                process.stdout.write(result.logs);
+            process.exitCode = result.ok ? 0 : (result.code || 1);
+            return;
+        }
+        throw new Error('Usage: host-setup <check dependency <id>|check service <id>|list|versions|install <id>> [--namespace <ns>] [--json]');
+    }
     if (cmd === 'we') {
         const action = cleanOpt(args[1] ?? null);
         if (!action) {
@@ -521,7 +572,7 @@ async function main() {
     if (cmd === 'live') {
         const action = cleanOpt(args[1] ?? null);
         if (!action)
-            throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|doctor> ...');
+            throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|view|doctor> ...');
         if (action === 'init') {
             console.log(JSON.stringify((0, live_1.liveInit)(), null, 2));
             return;
@@ -713,7 +764,7 @@ async function main() {
             console.log(JSON.stringify((0, live_1.liveViewData)(), null, 2));
             return;
         }
-        throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|doctor> ...');
+        throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|view|doctor> ...');
     }
     // Regular commands (need config/state)
     const config = (0, config_1.loadConfig)();

package/dist/core/setup.js

@@ -0,0 +1,416 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOST_SERVICE_DEFS = exports.HOST_DEPENDENCY_DEFS = void 0;
+exports.resolveHostBinPath = resolveHostBinPath;
+exports.checkSetupDependency = checkSetupDependency;
+exports.checkSetupService = checkSetupService;
+exports.listSetupStatus = listSetupStatus;
+exports.listSetupVersions = listSetupVersions;
+exports.installSetupItem = installSetupItem;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const exec_1 = require("../utils/exec");
+const init_1 = require("./init");
+const systemd_1 = require("./systemd");
+const ROOT_DIR = (0, node_path_1.resolve)(__dirname, '..', '..');
+const RELEASE_CACHE = new Map();
+exports.HOST_DEPENDENCY_DEFS = [
+    { id: 'kitowall', bin: 'kitowall', label: 'Kitowall CLI', installer: 'kitowall-only' },
+    { id: 'kitsune', bin: 'kitsune', label: 'Kitsune', installer: 'kitsune-only' },
+    { id: 'kitsune-rendercore', bin: 'kitsune-rendercore', label: 'Kitsune RenderCore', installer: 'kitsune-only' },
+    { id: 'swww', bin: 'swww', label: 'swww', installer: 'swww', system: true },
+    { id: 'swww-daemon', bin: 'swww-daemon', label: 'swww-daemon', installer: 'swww-daemon', system: true },
+    { id: 'hyprctl', bin: 'hyprctl', label: 'hyprctl', installer: 'hyprctl', system: true },
+    { id: 'cava', bin: 'cava', label: 'cava', installer: 'cava', system: true }
+];
+exports.HOST_SERVICE_DEFS = [
+    { id: 'kitowall-config', label: 'Kitowall config', installer: 'kitowall-config' },
+    { id: 'kitowall-next.timer', label: 'kitowall-next.timer', installer: 'kitowall-next.timer' },
+    { id: 'kitsune-rendercore.service', label: 'kitsune-rendercore.service', installer: 'kitsune-rendercore.service' }
+];
+function homeDir() {
+    return process.env.HOME || (0, node_os_1.homedir)();
+}
+async function fileExists(targetPath) {
+    try {
+        await node_fs_1.promises.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeReleaseVersion(input) {
+    return String(input ?? '').trim().replace(/^v/, '');
+}
+function uniqueEntries(values) {
+    return [...new Set(values.map(value => String(value).trim()).filter(Boolean))];
+}
+function hostPathEntries() {
+    const home = homeDir();
+    return uniqueEntries([
+        (0, node_path_1.join)(home, '.local', 'bin'),
+        (0, node_path_1.join)(home, '.npm-global', 'bin'),
+        (0, node_path_1.join)(home, '.cargo', 'bin'),
+        ...(process.env.PATH ? process.env.PATH.split(':') : []),
+        '/usr/local/bin',
+        '/usr/bin',
+        '/bin'
+    ]);
+}
+async function resolveBinFromPathEntries(bin) {
+    for (const dir of hostPathEntries()) {
+        const candidate = (0, node_path_1.join)(dir, bin);
+        if (await fileExists(candidate))
+            return candidate;
+    }
+    return '';
+}
+async function collectNpmPrefixBinDirs() {
+    const dirs = [];
+    const home = homeDir();
+    for (const args of [
+        ['config', 'get', 'prefix'],
+        ['prefix', '-g']
+    ]) {
+        try {
+            const out = await (0, exec_1.run)('npm', args, {
+                env: {
+                    ...process.env,
+                    HOME: home,
+                    PATH: hostPathEntries().join(':')
+                },
+                timeoutMs: 1500
+            });
+            const prefix = out.stdout.trim();
+            if (!prefix || prefix === 'undefined' || prefix === 'null')
+                continue;
+            const candidate = (0, node_path_1.join)(prefix, 'bin');
+            if (await fileExists(candidate)) {
+                dirs.push(candidate);
+                continue;
+            }
+            if (await fileExists(prefix))
+                dirs.push(prefix);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return uniqueEntries(dirs);
+}
+async function resolveHostBinPath(bin) {
+    const home = homeDir();
+    const fallback = {
+        kitowall: [
+            (0, node_path_1.join)(home, '.local', 'bin', 'kitowall'),
+            (0, node_path_1.join)(home, '.npm-global', 'bin', 'kitowall'),
+            (0, node_path_1.join)(home, 'node_modules', '.bin', 'kitowall')
+        ],
+        kitsune: [
+            (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune'),
+            (0, node_path_1.join)(home, '.local', 'bin', 'kitsune'),
+            (0, node_path_1.join)(home, '.local', 'share', 'kitsune', 'bin', 'kitsune')
+        ],
+        'kitsune-rendercore': [
+            (0, node_path_1.join)(home, '.cargo', 'bin', 'kitsune-rendercore'),
+            (0, node_path_1.join)(home, '.local', 'bin', 'kitsune-rendercore')
+        ]
+    }[bin] ?? [(0, node_path_1.join)(home, '.local', 'bin', bin)];
+    for (const candidate of fallback) {
+        if (await fileExists(candidate))
+            return candidate;
+    }
+    const byPath = await resolveBinFromPathEntries(bin);
+    if (byPath)
+        return byPath;
+    if (bin === 'kitowall') {
+        for (const dir of await collectNpmPrefixBinDirs()) {
+            const candidate = (0, node_path_1.join)(dir, bin);
+            if (await fileExists(candidate))
+                return candidate;
+        }
+    }
+    return '';
+}
+function bootstrapHostPath() {
+    return (0, node_path_1.join)(ROOT_DIR, 'scripts', 'bootstrap-host.sh');
+}
+function bootstrapSystemPath() {
+    return (0, node_path_1.join)(ROOT_DIR, 'scripts', 'bootstrap-system.sh');
+}
+async function assertBootstrapScriptExists(targetPath, label) {
+    if (await fileExists(targetPath))
+        return;
+    throw new Error(`${label} not found at ${targetPath}. Reinstala el CLI con: npm i -g --prefix ~/.local kitowall@latest`);
+}
+async function bootstrapVersionsPath() {
+    return (0, node_path_1.join)(homeDir(), '.local', 'share', 'kitowall', 'bootstrap-versions.json');
+}
+async function readBootstrapVersion(component) {
+    try {
+        const raw = await node_fs_1.promises.readFile(await bootstrapVersionsPath(), 'utf8');
+        const data = JSON.parse(raw);
+        const version = String(data?.[component]?.version ?? '').trim();
+        return version || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function readCliVersion(binPath) {
+    try {
+        const realPath = await node_fs_1.promises.realpath(binPath);
+        const pkgPath = (0, node_path_1.join)((0, node_path_1.dirname)(realPath), '..', 'package.json');
+        const raw = await node_fs_1.promises.readFile(pkgPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const value = normalizeReleaseVersion(parsed.version ?? '');
+        if (value)
+            return value;
+    }
+    catch {
+        // fallback to executing the bin
+    }
+    try {
+        const out = await (0, exec_1.run)(binPath, ['--version'], {
+            env: {
+                ...process.env,
+                HOME: homeDir(),
+                PATH: hostPathEntries().join(':')
+            },
+            timeoutMs: 1500
+        });
+        const value = normalizeReleaseVersion(out.stdout.trim());
+        return value || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function githubLatestReleaseTag(repo) {
+    const cached = RELEASE_CACHE.get(repo);
+    if (cached && Date.now() - cached.at < 300000)
+        return cached.value;
+    try {
+        const out = await (0, exec_1.run)('curl', ['-fsSL', '--connect-timeout', '1', '--max-time', '2', '-H', 'User-Agent: kitowall-cli', `https://api.github.com/repos/${repo}/releases/latest`], {
+            env: {
+                ...process.env,
+                HOME: homeDir(),
+                PATH: hostPathEntries().join(':')
+            },
+            timeoutMs: 2500
+        });
+        const data = JSON.parse(out.stdout);
+        const value = normalizeReleaseVersion(data?.tag_name ?? '') || null;
+        RELEASE_CACHE.set(repo, { at: Date.now(), value });
+        return value;
+    }
+    catch {
+        RELEASE_CACHE.set(repo, { at: Date.now(), value: null });
+        return null;
+    }
+}
+async function componentUpdateInfo(id, binPath = '') {
+    const repo = {
+        kitowall: 'KitotsuMolina/Kitowall',
+        kitsune: 'KitotsuMolina/Kitsune',
+        'kitsune-rendercore': 'KitotsuMolina/Kitsune-RenderCore'
+    }[id];
+    let localVersion = null;
+    if (id === 'kitowall' && binPath) {
+        localVersion = await readCliVersion(binPath);
+    }
+    else {
+        localVersion = await readBootstrapVersion(id);
+    }
+    const latestVersion = repo ? await githubLatestReleaseTag(repo) : null;
+    return {
+        local_version: localVersion,
+        latest_version: latestVersion,
+        update_available: !!(localVersion && latestVersion && localVersion !== latestVersion)
+    };
+}
+async function maybeSystemctlShow(unit, props) {
+    try {
+        const args = ['--user', 'show', unit, '--no-pager'];
+        for (const prop of props)
+            args.push('-p', prop);
+        const out = await (0, exec_1.run)('systemctl', args, {
+            env: {
+                ...process.env,
+                HOME: homeDir(),
+                PATH: hostPathEntries().join(':')
+            },
+            timeoutMs: 1500
+        });
+        const result = {};
+        for (const line of out.stdout.split('\n')) {
+            const idx = line.indexOf('=');
+            if (idx > -1)
+                result[line.slice(0, idx)] = line.slice(idx + 1);
+        }
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkSetupDependency(id) {
+    const def = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === id);
+    if (!def)
+        throw new Error(`Unknown dependency id: ${id}`);
+    let binPath = '';
+    let error = '';
+    try {
+        binPath = await resolveHostBinPath(def.bin);
+    }
+    catch (err) {
+        error = err instanceof Error ? err.message : String(err);
+    }
+    let update = { local_version: null, latest_version: null, update_available: false };
+    try {
+        if (def.id === 'kitowall' || def.id === 'kitsune' || def.id === 'kitsune-rendercore') {
+            update = await componentUpdateInfo(def.id, binPath);
+        }
+    }
+    catch (err) {
+        if (!error)
+            error = err instanceof Error ? err.message : String(err);
+    }
+    return {
+        id: def.id,
+        label: def.label,
+        installed: !!binPath,
+        state: binPath ? 'ok' : error ? 'error' : 'missing',
+        path: binPath,
+        detail: binPath ? `path=${binPath}` : 'binary not found',
+        error,
+        update
+    };
+}
+async function checkSetupService(id, namespace = 'kitowall') {
+    const def = exports.HOST_SERVICE_DEFS.find(item => item.id === id);
+    if (!def)
+        throw new Error(`Unknown service id: ${id}`);
+    const home = homeDir();
+    const configPath = (0, node_path_1.join)(home, '.config', 'kitowall', 'config.json');
+    const timerUnitPath = (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitowall-next.timer');
+    const rendercoreUnitPath = (0, node_path_1.join)(home, '.config', 'systemd', 'user', 'kitsune-rendercore.service');
+    if (id === 'kitowall-config') {
+        const installed = await fileExists(configPath);
+        return {
+            id,
+            label: def.label,
+            installed,
+            state: installed ? 'ok' : 'missing',
+            path: configPath,
+            detail: installed ? `namespace=${namespace}` : 'config.json missing',
+            error: ''
+        };
+    }
+    if (id === 'kitowall-next.timer') {
+        const installed = await fileExists(timerUnitPath);
+        const status = installed ? await maybeSystemctlShow('kitowall-next.timer', ['ActiveState', 'UnitFileState']) : null;
+        return {
+            id,
+            label: def.label,
+            installed,
+            state: installed ? 'ok' : 'missing',
+            path: timerUnitPath,
+            detail: installed
+                ? (status
+                    ? `file=${timerUnitPath} active=${String(status.ActiveState ?? 'n/a')} unit=${String(status.UnitFileState ?? 'n/a')}`
+                    : `file=${timerUnitPath} status=unavailable`)
+                : 'timer unit file missing',
+            error: ''
+        };
+    }
+    if (id === 'kitsune-rendercore.service') {
+        const installed = await fileExists(rendercoreUnitPath);
+        const status = installed ? await maybeSystemctlShow('kitsune-rendercore.service', ['ActiveState', 'UnitFileState']) : null;
+        return {
+            id,
+            label: def.label,
+            installed,
+            state: installed ? 'ok' : 'missing',
+            path: rendercoreUnitPath,
+            detail: installed
+                ? (status
+                    ? `file=${rendercoreUnitPath} active=${String(status.ActiveState ?? 'n/a')} unit=${String(status.UnitFileState ?? 'n/a')}`
+                    : `file=${rendercoreUnitPath} status=unavailable`)
+                : 'service unit file missing',
+            error: ''
+        };
+    }
+    throw new Error(`Unknown service id: ${id}`);
+}
+async function listSetupStatus(namespace = 'kitowall') {
+    const [dependencies, services] = await Promise.all([
+        Promise.all(exports.HOST_DEPENDENCY_DEFS.map(item => checkSetupDependency(item.id))),
+        Promise.all(exports.HOST_SERVICE_DEFS.map(item => checkSetupService(item.id, namespace)))
+    ]);
+    return {
+        ok: dependencies.every(item => item.installed) && services.every(item => item.installed),
+        dependencies,
+        services,
+        counts: {
+            dependencies_missing: dependencies.filter(item => !item.installed).length,
+            services_missing: services.filter(item => !item.installed).length,
+            updates_available: dependencies.filter(item => item.update?.update_available === true).length
+        }
+    };
+}
+async function listSetupVersions() {
+    const items = {};
+    for (const id of ['kitowall', 'kitsune', 'kitsune-rendercore']) {
+        const dep = await checkSetupDependency(id);
+        items[id] = dep.update ?? { local_version: null, latest_version: null, update_available: false };
+    }
+    return { ok: true, items };
+}
+async function runBootstrapHostMode(mode) {
+    const scriptPath = bootstrapHostPath();
+    await assertBootstrapScriptExists(scriptPath, 'bootstrap-host.sh');
+    const out = await (0, exec_1.run)('bash', [scriptPath], {
+        env: {
+            ...process.env,
+            HOME: homeDir(),
+            PATH: hostPathEntries().join(':'),
+            KITOWALL_SKIP_SYSTEM_DEPS: '1',
+            KITOWALL_BOOTSTRAP_MODE: mode
+        }
+    });
+    return { ok: true, code: out.code, logs: `${out.stdout}${out.stderr}` };
+}
+async function runBootstrapSystemItems(ids) {
+    const scriptPath = bootstrapSystemPath();
+    await assertBootstrapScriptExists(scriptPath, 'bootstrap-system.sh');
+    const out = await (0, exec_1.run)('pkexec', ['bash', scriptPath, ...ids], {
+        env: {
+            ...process.env,
+            HOME: homeDir(),
+            PATH: hostPathEntries().join(':')
+        }
+    });
+    return { ok: true, code: out.code, logs: `${out.stdout}${out.stderr}` };
+}
+async function installSetupItem(id, namespace = 'kitowall') {
+    const dep = exports.HOST_DEPENDENCY_DEFS.find(item => item.id === id);
+    if (dep?.system)
+        return await runBootstrapSystemItems([id]);
+    if (id === 'kitowall')
+        return await runBootstrapHostMode('kitowall-only');
+    if (id === 'kitsune' || id === 'kitsune-rendercore' || id === 'kitsune-rendercore.service') {
+        return await runBootstrapHostMode('kitsune-only');
+    }
+    if (id === 'kitowall-config') {
+        await (0, init_1.initKitowall)({ namespace, apply: true, force: true });
+        return { ok: true, code: 0, logs: JSON.stringify({ ok: true, init: true, namespace }, null, 2) };
+    }
+    if (id === 'kitowall-next.timer') {
+        await (0, systemd_1.installSystemd)({ every: '600s' });
+        return { ok: true, code: 0, logs: JSON.stringify({ ok: true, installed: true, every: '600s' }, null, 2) };
+    }
+    throw new Error(`Unsupported setup item: ${id}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitowall",
-  "version": "7.5.0",
+  "version": "7.9.0",
   "description": "CLI/daemon for Hyprland wallpapers using swww with pack-based rotation.",
   "repository": {
     "type": "git",
@@ -10,6 +10,8 @@
   "type": "commonjs",
   "files": [
     "dist",
+    "scripts/bootstrap-host.sh",
+    "scripts/bootstrap-system.sh",
     "README.md",
     "LICENSE.md",
     "NOTICE.md",