@kvman/kernel 0.1.0

package/dist/kernel.js

@@ -0,0 +1,157 @@
+import { mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { systemClock } from "./clock.js";
+import { createIdGenerator } from "./ids.js";
+import { createDispatcher } from "./jobs/dispatcher.js";
+import { createJobRows } from "./jobs/job-rows.js";
+import { createProgressHub } from "./jobs/progress-hub.js";
+import { answerWorker, queuableCommand } from "./kernel-requests.js";
+import { runStartedHandlers, stopRun } from "./kernel-lifecycle.js";
+import { kernelVersion } from "./kernel-version.js";
+import { createKernelWeb } from "./kernel-web.js";
+import { installMissing } from "./extensions/npm-install.js";
+import { readExtensions } from "./extensions/manifests.js";
+import { checkTrust } from "./extensions/trust.js";
+import { createFiles } from "./files/files.js";
+import { kernelCatalogOwner, readOwnerCatalogs } from "./localization/catalogs.js";
+import { openLogFile } from "./logging/log-file.js";
+import { createPresetStore } from "./preset-edit/preset-store.js";
+import { createProcessService } from "./processes/process-service.js";
+import { reloadExtensions } from "./reload/reload-extensions.js";
+import { watchExtensions } from "./reload/watcher.js";
+import { startExtensionRun } from "./run/extension-run.js";
+import { createScheduleRows } from "./schedules/schedule-rows.js";
+import { kernelSdkVersion } from "./sdk-version.js";
+import { openSecretsFile } from "./secrets/secrets-file.js";
+import { kernelSettingDefinitions } from "./settings/kernel-settings.js";
+import { createSettings } from "./settings/settings.js";
+import { openDatabase } from "./storage/database.js";
+import { keepWasmCode } from "./wasm-code-gc.js";
+import { createWorkspaces, homeWorkspaceId, openWorkspaceOf } from "./workspaces/workspaces.js";
+const hourMs = 60 * 60 * 1000;
+const dayMs = 24 * hourMs;
+function kernelSettings(connection, presetSettings, languages, logger) {
+    const definitions = new Map(kernelSettingDefinitions(languages).map((definition) => [definition.key, definition]));
+    const settings = createSettings({ connection, definitions, presetValues: presetSettings, logger });
+    const number = (key) => z.number().parse(settings.resolve(key, homeWorkspaceId).value);
+    return { settings, workers: number('kernel.workers'), concurrency: number('kernel.workerConcurrency'), retentionDays: number('kernel.jobs.retentionDays') };
+}
+export async function startKernel(options) {
+    keepWasmCode();
+    mkdirSync(options.home, { recursive: true });
+    const clock = options.clock ?? systemClock;
+    const startedAt = clock.now();
+    const database = path.join(options.home, 'kvman.db');
+    const connection = openDatabase(database);
+    const logFile = openLogFile(options.home, options.logLevel, options.terminalLog);
+    const logger = logFile.logger;
+    const secrets = openSecretsFile(options.home);
+    const ids = createIdGenerator(clock);
+    const workspaces = createWorkspaces(connection, options.homeFolder, ids);
+    const rows = createJobRows(connection, clock, ids, workspaces.closed);
+    const schedules = createScheduleRows(connection, clock, ids, workspaces.closed);
+    const hub = createProgressHub((rootId) => dispatcher.waitForJob(rootId));
+    const workspace = (id) => openWorkspaceOf(connection, options.homeFolder, id);
+    const dispatcher = createDispatcher({ connection, rows, schedules, clock, logger, workspaceOf: workspace });
+    const processes = createProcessService({ connection, home: options.home, clock, logger, platform: process.platform, deliverAlong: (work) => dispatcher.deliverAlong(work) });
+    const stopping = new AbortController();
+    let requestRestart = () => undefined;
+    const restartRequested = new Promise((resolve) => {
+        requestRestart = resolve;
+    });
+    let retention;
+    let watcher;
+    const closeStorage = () => {
+        retention?.();
+        logFile.close();
+        connection.close();
+    };
+    try {
+        processes.killLeftovers();
+        const folders = { home: options.home, presetFolder: options.presetFolder, bundled: options.bundled };
+        installMissing(options.preset, options.home, logger, process.platform);
+        const loaded = readExtensions(options.preset, folders);
+        await checkTrust(connection, clock, loaded, options.trust);
+        const preset = createPresetStore({
+            home: options.home,
+            preset: options.preset,
+            source: options.presetSource ?? { origin: 'bundled' },
+            bundled: options.bundled,
+            dependencies: new Map(loaded.map((extension) => [extension.name, Object.keys(extension.manifest.kvman.dependencies ?? {})])),
+        });
+        const presetSettings = options.preset.settings ?? {};
+        const kernelCatalogs = readOwnerCatalogs(kernelCatalogOwner);
+        const settings = kernelSettings(connection, presetSettings, [...kernelCatalogs.keys()], logger);
+        const health = () => ({
+            version: kernelVersion(),
+            preset: options.preset.name,
+            mode: options.mode,
+            workers: settings.workers,
+            uptimeMs: clock.now() - startedAt,
+            languages: run.catalogs().languages,
+            ...(options.rolledBack === undefined ? {} : { rolledBack: options.rolledBack }),
+        });
+        const run = await startExtensionRun({
+            preset: options.preset,
+            folders,
+            sdkVersion: kernelSdkVersion(),
+            kernelCatalogs,
+            logger,
+            pool: {
+                size: settings.workers,
+                concurrency: settings.concurrency,
+                setup: { home: options.home, homeFolder: options.homeFolder, database, presetSettings, logLevel: options.logLevel, terminalLog: options.terminalLog },
+                logger,
+                events: {
+                    request: (request) => answerWorker({ dispatcher, schedules, secrets, clock, workspaces, processes, preset, health, requestRestart }, request),
+                    progress: (rootId, chunk) => hub.publish(rootId, chunk),
+                    syncEnded: (end) => dispatcher.deliverSyncEnd(end),
+                    slotFreed: () => dispatcher.slotFreed(),
+                },
+            },
+        });
+        dispatcher.attach(run.pool(), run.pool().summary.handlers);
+        const cleanUp = () => {
+            rows.deleteFinishedBefore(clock.now() - settings.retentionDays * dayMs);
+            retention = clock.setTimer(hourMs, cleanUp);
+        };
+        cleanUp();
+        dispatcher.interruptLeftovers();
+        dispatcher.wake();
+        dispatcher.deliverAlong((deliverIn) => workspaces.openHomeFirstTime((workspaceId) => deliverIn('kernel.workspace.opened', { workspaceId }, workspaceId)));
+        const startWorkspace = dispatcher.deliverAlong((deliverIn) => workspaces.open(options.startFolder, (workspaceId) => deliverIn('kernel.workspace.opened', { workspaceId }, workspaceId)));
+        const started = run.pool().summary.handlers.filter((handler) => handler.point === 'kernel.started').map((handler) => handler.extension);
+        await runStartedHandlers(dispatcher, logger, run.extensions().map((extension) => extension.name), started);
+        watcher = watchExtensions(run.folders(), logger, (changed) => reloadExtensions(run, dispatcher, logger, changed, stopping.signal));
+        const activeWatcher = watcher;
+        return {
+            exec: async (name, input, { caller, workspaceId, jobId }) => run.pool().run({ id: jobId ?? ids(), name, input, workspace: workspace(workspaceId), caller, async: false, fromHandler: false }),
+            execAsync: async (name, input, { caller, workspaceId }) => {
+                const { retries } = queuableCommand(run.pool().summary, name, caller);
+                workspace(workspaceId);
+                return dispatcher.queue({ name, input, workspaceId, caller, retries, fromHandler: false, runAt: clock.now() });
+            },
+            cancel: (jobId) => dispatcher.cancel(jobId),
+            waitForJob: (jobId) => dispatcher.waitForJob(jobId),
+            watchProgress: (jobId, listener) => hub.watch(jobId, listener),
+            catalog: (language) => run.catalogs().catalog(language),
+            web: createKernelWeb({ connection, run, files: createFiles({ connection, home: options.home, ids, clock }), settings: settings.settings, ids, workspace, logger }),
+            startWorkspace,
+            restartRequested,
+            settled: () => dispatcher.settled(),
+            close: async () => {
+                stopping.abort();
+                await activeWatcher.close();
+                await stopRun(dispatcher, run, processes);
+                closeStorage();
+            },
+        };
+    }
+    catch (error) {
+        await watcher?.close();
+        closeStorage();
+        throw error;
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

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

package/dist/limits.d.ts

@@ -0,0 +1,6 @@
+export declare const documentLimitBytes: number;
+export declare const fileLimitBytes: number;
+export declare const findLimitMaximum = 1000;
+export declare const progressLimitBytes: number;
+export declare const progressReplayBytes: number;
+//# sourceMappingURL=limits.d.ts.map

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,QAAgB,CAAC;AAEhD,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C,eAAO,MAAM,mBAAmB,QAAa,CAAC"}

package/dist/limits.js

@@ -0,0 +1,8 @@
+// The kernel's limits (plan 02 §2.13).
+const mebibyte = 1024 * 1024;
+export const documentLimitBytes = 16 * mebibyte;
+export const fileLimitBytes = 1024 * mebibyte;
+export const findLimitMaximum = 1000;
+export const progressLimitBytes = 64 * 1024;
+export const progressReplayBytes = 256 * 1024;
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,QAAQ,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC"}

package/dist/localization/catalogs.d.ts

@@ -0,0 +1,15 @@
+export type Catalog = Record<string, string>;
+export type OwnerCatalogs = ReadonlyMap<string, Catalog>;
+export type CatalogOwner = {
+    name: string;
+    namespace: string;
+    folder: string;
+};
+export declare const kernelCatalogOwner: CatalogOwner;
+export declare function readOwnerCatalogs(owner: CatalogOwner): OwnerCatalogs;
+export type Catalogs = {
+    languages: string[];
+    catalog(language: string): Catalog;
+};
+export declare function mergeCatalogs(owners: Iterable<OwnerCatalogs>): Catalogs;
+//# sourceMappingURL=catalogs.d.ts.map

package/dist/localization/catalogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.d.ts","sourceRoot":"","sources":["../../src/localization/catalogs.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAG7C,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAI/E,eAAO,MAAM,kBAAkB,EAAE,YAIhC,CAAC;AA+BF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAKpE;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,QAAQ,CAavE"}

package/dist/localization/catalogs.js

@@ -0,0 +1,66 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+import { kernelExtension } from "../settings/kernel-settings.js";
+const catalogSchema = z.record(z.string(), z.string());
+export const kernelCatalogOwner = {
+    name: kernelExtension,
+    namespace: 'kernel',
+    folder: fileURLToPath(new URL('../..', import.meta.url)),
+};
+function invalid(owner, message) {
+    return kernelProblem('EXTENSION_INVALID', `${owner.name}: ${message}`, { extension: owner.name });
+}
+function languageOf(owner, file) {
+    const code = file.slice(0, -'.json'.length);
+    try {
+        Intl.getCanonicalLocales(code);
+    }
+    catch {
+        throw invalid(owner, `locales/${file} isn't named after a language code (BCP 47).`);
+    }
+    return code;
+}
+function readCatalog(owner, file) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path.join(owner.folder, 'locales', file), 'utf8'));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw invalid(owner, `locales/${file} can't be read (${reason}).`);
+    }
+    const catalog = catalogSchema.safeParse(parsed);
+    if (!catalog.success)
+        throw invalid(owner, `locales/${file} must be a flat object of strings.`);
+    const outside = Object.keys(catalog.data).find((key) => !key.startsWith(`${owner.namespace}.`));
+    if (outside !== undefined)
+        throw invalid(owner, `locales/${file} has the key "${outside}", outside the namespace "${owner.namespace}".`);
+    return catalog.data;
+}
+export function readOwnerCatalogs(owner) {
+    const folder = path.join(owner.folder, 'locales');
+    if (!existsSync(folder))
+        return new Map();
+    const files = readdirSync(folder).filter((file) => file.endsWith('.json'));
+    return new Map(files.map((file) => [languageOf(owner, file), readCatalog(owner, file)]));
+}
+export function mergeCatalogs(owners) {
+    const merged = new Map();
+    for (const catalogs of owners) {
+        for (const [language, catalog] of catalogs)
+            merged.set(language, { ...merged.get(language), ...catalog });
+    }
+    return {
+        languages: [...merged.keys()].sort(),
+        catalog(language) {
+            const own = merged.get(language);
+            if (own === undefined)
+                throw kernelProblem('NOT_FOUND', `No loaded catalog has the language "${language}".`, { language });
+            return { ...merged.get('en'), ...own };
+        },
+    };
+}
+//# sourceMappingURL=catalogs.js.map

package/dist/localization/catalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../src/localization/catalogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAYjE,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CACzD,CAAC;AAEF,SAAS,OAAO,CAAC,KAAmB,EAAE,OAAe;IACnD,OAAO,aAAa,CAAC,mBAAmB,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB,EAAE,IAAY;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,IAAI,8CAA8C,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB,EAAE,IAAY;IACpD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,IAAI,mBAAmB,MAAM,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,IAAI,oCAAoC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAChG,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,KAAK,EAAE,WAAW,IAAI,iBAAiB,OAAO,6BAA6B,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IACzI,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAID,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACpC,OAAO,CAAC,QAAQ;YACd,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,aAAa,CAAC,WAAW,EAAE,uCAAuC,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3H,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/logging/log-file.d.ts

@@ -0,0 +1,7 @@
+import type { KernelLogger, LogLevel } from './logger.ts';
+export type LogFile = {
+    logger: KernelLogger;
+    close(): void;
+};
+export declare function openLogFile(home: string, level: LogLevel, terminal: boolean): LogFile;
+//# sourceMappingURL=log-file.d.ts.map

package/dist/logging/log-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-file.d.ts","sourceRoot":"","sources":["../../src/logging/log-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ1D,MAAM,MAAM,OAAO,GAAG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAE9D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAMrF"}

package/dist/logging/log-file.js

@@ -0,0 +1,12 @@
+import path from 'node:path';
+import { destination as fileDestination } from 'pino';
+import { createKernelLogger } from "./logger.js";
+import { terminalDestination } from "./terminal-lines.js";
+export function openLogFile(home, level, terminal) {
+    const destination = fileDestination({ dest: path.join(home, 'logs', 'kvman.log'), mkdir: true, sync: true, append: true });
+    return {
+        logger: createKernelLogger(terminal ? [destination, terminalDestination] : [destination], level),
+        close: () => destination.end(),
+    };
+}
+//# sourceMappingURL=log-file.js.map

package/dist/logging/log-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-file.js","sourceRoot":"","sources":["../../src/logging/log-file.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,MAAM,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAe,EAAE,QAAiB;IAC1E,MAAM,WAAW,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3H,OAAO;QACL,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;QAChG,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;KAC/B,CAAC;AACJ,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,12 @@
+import { type DestinationStream } from 'pino';
+import type { Json } from '@kvman/sdk';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogFields = Readonly<Record<string, Json>>;
+export type KernelLogger = {
+    debug(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+};
+export declare function createKernelLogger(destinations: readonly DestinationStream[], level: LogLevel): KernelLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAA6B,MAAM,MAAM,CAAC;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAClD,CAAC;AAYF,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAE5G"}

package/dist/logging/logger.js

@@ -0,0 +1,14 @@
+import { multistream, pino } from 'pino';
+function wrap(logger) {
+    return {
+        debug: (message, fields) => logger.debug(fields ?? {}, message),
+        info: (message, fields) => logger.info(fields ?? {}, message),
+        warn: (message, fields) => logger.warn(fields ?? {}, message),
+        error: (message, fields) => logger.error(fields ?? {}, message),
+    };
+}
+// Every record at `level` goes to each destination.
+export function createKernelLogger(destinations, level) {
+    return wrap(pino({ level, base: null }, multistream(destinations.map((stream) => ({ stream, level })))));
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAqD,MAAM,MAAM,CAAC;AAiB5F,SAAS,IAAI,CAAC,MAAkB;IAC9B,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;QAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;QAC7D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;QAC7D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,YAA0C,EAAE,KAAe;IAC5F,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC"}

package/dist/logging/terminal-lines.d.ts

@@ -0,0 +1,4 @@
+import type { DestinationStream } from 'pino';
+export declare function terminalLine(record: string): string;
+export declare const terminalDestination: DestinationStream;
+//# sourceMappingURL=terminal-lines.d.ts.map

package/dist/logging/terminal-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-lines.d.ts","sourceRoot":"","sources":["../../src/logging/terminal-lines.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAa9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAA6F,CAAC"}

package/dist/logging/terminal-lines.js

@@ -0,0 +1,16 @@
+import { z } from '@kvman/sdk';
+// The short terminal log (ADR 0009, 49): each record as one English line, `HH:MM:SS LEVEL message`, on stderr. Only
+// the time, level, and message are shown; a record's fields stay in `logs/kvman.log`.
+const levelNames = { 10: 'TRACE', 20: 'DEBUG', 30: 'INFO', 40: 'WARN', 50: 'ERROR', 60: 'FATAL' };
+const recordSchema = z.object({ level: z.number(), time: z.number(), msg: z.string() });
+function twoDigits(value) {
+    return String(value).padStart(2, '0');
+}
+export function terminalLine(record) {
+    const { level, time, msg } = recordSchema.parse(JSON.parse(record));
+    const at = new Date(time);
+    const clock = `${twoDigits(at.getHours())}:${twoDigits(at.getMinutes())}:${twoDigits(at.getSeconds())}`;
+    return `${clock} ${levelNames[level] ?? String(level)} ${msg}\n`;
+}
+export const terminalDestination = { write: (record) => process.stderr.write(terminalLine(record)) };
+//# sourceMappingURL=terminal-lines.js.map

package/dist/logging/terminal-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-lines.js","sourceRoot":"","sources":["../../src/logging/terminal-lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAG/B,oHAAoH;AACpH,sFAAsF;AAEtF,MAAM,UAAU,GAAqC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAEpI,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAExF,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IACxG,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAsB,EAAE,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC"}

package/dist/preset-edit/install-source.d.ts

@@ -0,0 +1,8 @@
+import { type ExtensionSource, type InstallSource } from '@kvman/sdk';
+export type ResolvedInstall = {
+    name: string;
+    storedSource: ExtensionSource;
+};
+/** The name and the stored source of `source`; a `path:` folder resolves against the folder of the preset file written. */
+export declare function resolveInstallSource(source: InstallSource, presetFolder: string): Promise<ResolvedInstall>;
+//# sourceMappingURL=install-source.d.ts.map

package/dist/preset-edit/install-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-source.d.ts","sourceRoot":"","sources":["../../src/preset-edit/install-source.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAMzF,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,eAAe,CAAA;CAAE,CAAC;AAsB9E,2HAA2H;AAC3H,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAShH"}

package/dist/preset-edit/install-source.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { packageNameSchema } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+const bundledPrefix = 'bundled:';
+const npmPrefix = 'npm:';
+const pathPrefix = 'path:';
+async function nameInFolder(folder) {
+    const file = path.join(folder, 'package.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw kernelProblem('VALIDATION_FAILED', `${file} can't be read (${reason}).`, { folder });
+    }
+    const name = typeof manifest === 'object' && manifest !== null && 'name' in manifest ? packageNameSchema.safeParse(manifest.name) : undefined;
+    if (name === undefined || !name.success) {
+        throw kernelProblem('VALIDATION_FAILED', `${file} has no valid package name.`, { folder });
+    }
+    return name.data;
+}
+/** The name and the stored source of `source`; a `path:` folder resolves against the folder of the preset file written. */
+export async function resolveInstallSource(source, presetFolder) {
+    if (source.startsWith(bundledPrefix))
+        return { name: source.slice(bundledPrefix.length), storedSource: 'bundled' };
+    if (source.startsWith(npmPrefix)) {
+        const nameAndVersion = source.slice(npmPrefix.length);
+        const versionStart = nameAndVersion.lastIndexOf('@');
+        return { name: nameAndVersion.slice(0, versionStart), storedSource: `npm:${nameAndVersion.slice(versionStart + 1)}` };
+    }
+    const folder = source.slice(pathPrefix.length);
+    return { name: await nameInFolder(path.resolve(presetFolder, folder)), storedSource: `path:${folder}` };
+}
+//# sourceMappingURL=install-source.js.map

package/dist/preset-edit/install-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-source.js","sourceRoot":"","sources":["../../src/preset-edit/install-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAA4C,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO/C,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B,KAAK,UAAU,YAAY,CAAC,MAAc;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,aAAa,CAAC,mBAAmB,EAAE,GAAG,IAAI,mBAAmB,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9I,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,aAAa,CAAC,mBAAmB,EAAE,GAAG,IAAI,6BAA6B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,2HAA2H;AAC3H,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAqB,EAAE,YAAoB;IACpF,IAAI,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACnH,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;IACxH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,MAAM,EAAE,EAAE,CAAC;AAC1G,CAAC"}

package/dist/preset-edit/preset-backup.d.ts

@@ -0,0 +1,10 @@
+import type { Preset } from '@kvman/sdk';
+/** The backup of a preset file. */
+export declare function presetBackupFor(file: string): string;
+/** Writes the backup of `file` from the preset as it runs, unless one exists: later edits keep the first. */
+export declare function keepPresetBackup(file: string, running: Preset): Promise<void>;
+/** Puts the backup in place of `file` and answers whether there was one. */
+export declare function restorePresetBackup(file: string): boolean;
+/** Deletes the backup of `file`, if any. */
+export declare function discardPresetBackup(file: string): void;
+//# sourceMappingURL=preset-backup.d.ts.map

package/dist/preset-edit/preset-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-backup.d.ts","sourceRoot":"","sources":["../../src/preset-edit/preset-backup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOzC,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,6GAA6G;AAC7G,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnF;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQzD;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtD"}

package/dist/preset-edit/preset-backup.js

@@ -0,0 +1,45 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { renameSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { kernelProblem } from "../problems.js";
+import { presetFileText } from "./preset-files.js";
+// The backup beside a preset file (plan 02 §2.10, ADR 0024, 4 and 5): `<file>.good` is the preset as it ran before the
+// first edit since a good start. A start that fails because of the preset restores it, and a good start deletes it.
+/** The backup of a preset file. */
+export function presetBackupFor(file) {
+    return `${file}.good`;
+}
+function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+/** Writes the backup of `file` from the preset as it runs, unless one exists: later edits keep the first. */
+export async function keepPresetBackup(file, running) {
+    const backup = presetBackupFor(file);
+    const text = presetFileText(backup, running);
+    try {
+        await mkdir(path.dirname(backup), { recursive: true });
+        await writeFile(backup, text, { flag: 'wx' });
+    }
+    catch (error) {
+        if (hasCode(error, 'EEXIST'))
+            return;
+        throw kernelProblem('VALIDATION_FAILED', `The preset backup ${backup} can't be written (${error instanceof Error ? error.message : String(error)}).`, { file: backup });
+    }
+}
+/** Puts the backup in place of `file` and answers whether there was one. */
+export function restorePresetBackup(file) {
+    try {
+        renameSync(presetBackupFor(file), file);
+        return true;
+    }
+    catch (error) {
+        if (hasCode(error, 'ENOENT'))
+            return false;
+        throw error;
+    }
+}
+/** Deletes the backup of `file`, if any. */
+export function discardPresetBackup(file) {
+    rmSync(presetBackupFor(file), { force: true });
+}
+//# sourceMappingURL=preset-backup.js.map

package/dist/preset-edit/preset-backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-backup.js","sourceRoot":"","sources":["../../src/preset-edit/preset-backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,uHAAuH;AACvH,oHAAoH;AAEpH,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,GAAG,IAAI,OAAO,CAAC;AACxB,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1E,CAAC;AAED,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAClE,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO;QACrC,MAAM,aAAa,CAAC,mBAAmB,EAAE,qBAAqB,MAAM,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1K,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC;QACH,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/preset-edit/preset-files.d.ts

@@ -0,0 +1,6 @@
+import { type Preset } from '@kvman/sdk';
+export declare function targetFileFor(home: string, name: string): string;
+export declare function readStoredPreset(file: string): Promise<Preset>;
+export declare function presetFileText(file: string, preset: Preset): string;
+export declare function writePresetFile(file: string, preset: Preset): Promise<void>;
+//# sourceMappingURL=preset-files.d.ts.map

package/dist/preset-edit/preset-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-files.d.ts","sourceRoot":"","sources":["../../src/preset-edit/preset-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAUvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAMD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAepE;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUnE;AAGD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF"}

package/dist/preset-edit/preset-files.js

@@ -0,0 +1,56 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { presetSchema } from '@kvman/sdk';
+import { kernelProblem } from "../problems.js";
+// Reading and writing the stored preset file (plan 02 §2.10, ADR 0010, 12 and 13): every read parses through the
+// schema, and every write is validated first and lands whole or not at all, through a temporary file and a rename.
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function targetFileFor(home, name) {
+    return path.join(home, 'presets', `${name}.json`);
+}
+function invalid(file, detail) {
+    return kernelProblem('VALIDATION_FAILED', `The preset file ${file} is invalid (${detail}).`, { file });
+}
+export async function readStoredPreset(file) {
+    const text = await readFile(file, 'utf8').catch((error) => {
+        throw kernelProblem('VALIDATION_FAILED', `The preset file ${file} can't be read (${reasonOf(error)}).`, { file });
+    });
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw invalid(file, reasonOf(error));
+    }
+    const result = presetSchema.safeParse(parsed);
+    if (!result.success) {
+        throw invalid(file, result.error.issues.map((issue) => `${issue.path.join('.') || 'preset'}: ${issue.message}`).join('; '));
+    }
+    return result.data;
+}
+// The written keys are `name`, `extensions`, then `settings` when present.
+export function presetFileText(file, preset) {
+    const ordered = preset.settings === undefined
+        ? { name: preset.name, extensions: preset.extensions }
+        : { name: preset.name, extensions: preset.extensions, settings: preset.settings };
+    const result = presetSchema.safeParse(ordered);
+    if (!result.success) {
+        throw invalid(file, result.error.issues.map((issue) => `${issue.path.join('.') || 'preset'}: ${issue.message}`).join('; '));
+    }
+    return `${JSON.stringify(result.data, null, 2)}\n`;
+}
+// `<home>/presets/` is made when missing.
+export async function writePresetFile(file, preset) {
+    const text = presetFileText(file, preset);
+    try {
+        await mkdir(path.dirname(file), { recursive: true });
+        await writeFile(`${file}.${String(process.pid)}.tmp`, text);
+        await rename(`${file}.${String(process.pid)}.tmp`, file);
+    }
+    catch (error) {
+        throw kernelProblem('VALIDATION_FAILED', `The preset file ${file} can't be written (${reasonOf(error)}).`, { file });
+    }
+}
+//# sourceMappingURL=preset-files.js.map

package/dist/preset-edit/preset-files.js.map

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

package/dist/preset-edit/preset-source.d.ts

@@ -0,0 +1,7 @@
+export type PresetSource = {
+    origin: 'bundled';
+} | {
+    origin: 'home' | 'file';
+    file: string;
+};
+//# sourceMappingURL=preset-source.d.ts.map

package/dist/preset-edit/preset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-source.d.ts","sourceRoot":"","sources":["../../src/preset-edit/preset-source.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/preset-edit/preset-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preset-source.js.map