@kvman/kernel 0.1.0

package/dist/workers/protocol.js

@@ -0,0 +1,93 @@
+import { callerSchema, extensionSourceSchema, installSourceSchema, jsonSchema, problemSchema, workspaceSchema, z } from '@kvman/sdk';
+// The messages between the main thread and a worker, checked on arrival like any other boundary.
+const secretWriteSchema = z.discriminatedUnion('action', [
+    z.object({ action: z.literal('set'), extension: z.string(), name: z.string(), value: z.string() }),
+    z.object({ action: z.literal('delete'), extension: z.string(), name: z.string() }),
+]);
+const scheduleTimingSchema = z.union([z.object({ at: z.string() }), z.object({ cron: z.string() })]);
+// What a worker asks the main thread to do, which owns the job and schedule rows (ADR 0009, 19).
+const workerRequestSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('write-secret'), write: secretWriteSchema }),
+    z.object({
+        kind: z.literal('queue-job'),
+        name: z.string(),
+        input: z.unknown(),
+        workspaceId: z.string(),
+        caller: callerSchema,
+        retries: z.number().int(),
+        fromHandler: z.boolean(),
+    }),
+    z.object({
+        kind: z.literal('schedule'),
+        name: z.string(),
+        input: z.unknown(),
+        timing: scheduleTimingSchema,
+        key: z.string().optional(),
+        workspaceId: z.string(),
+        owner: z.string(),
+        retries: z.number().int(),
+        fromHandler: z.boolean(),
+    }),
+    z.object({ kind: z.literal('cancel-schedule'), id: z.string(), owner: z.string() }),
+    z.object({ kind: z.literal('cancel-job'), jobId: z.string() }),
+    z.object({ kind: z.literal('open-workspace'), path: z.string() }),
+    z.object({ kind: z.literal('close-workspace'), workspaceId: z.string() }),
+    z.object({ kind: z.literal('preset-get') }),
+    z.object({ kind: z.literal('preset-install'), source: installSourceSchema }),
+    z.object({ kind: z.literal('preset-uninstall'), name: z.string() }),
+    z.object({ kind: z.literal('health') }),
+    z.object({ kind: z.literal('restart') }),
+    z.object({
+        kind: z.literal('start-process'),
+        extension: z.string(),
+        workspace: workspaceSchema,
+        name: z.string(),
+        options: z.object({ command: z.string(), args: z.array(z.string()), cwd: z.string().optional(), env: z.record(z.string(), z.string()) }),
+    }),
+    z.object({ kind: z.literal('stop-process'), extension: z.string(), workspaceId: z.string(), name: z.string() }),
+]);
+export const workerSetupSchema = z.object({
+    home: z.string(),
+    homeFolder: z.string(),
+    database: z.string(),
+    extensions: z.array(z.object({ name: z.string(), namespace: z.string(), entryUrl: z.string(), version: z.string(), source: extensionSourceSchema, revision: z.number().int() })),
+    languages: z.array(z.string()),
+    presetSettings: z.record(z.string(), jsonSchema),
+    logLevel: z.enum(['debug', 'info', 'warn', 'error']),
+    terminalLog: z.boolean(),
+    checkPresetSettings: z.boolean(),
+    mainArgv: z.array(z.string()),
+});
+const rootJobSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    input: z.unknown(),
+    workspace: workspaceSchema,
+    caller: callerSchema,
+    async: z.boolean(),
+    fromHandler: z.boolean(),
+    handlerExtension: z.string().optional(),
+});
+export const abortReasons = ['cancel', 'shutdown'];
+export const toWorkerSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('run'), requestId: z.number(), job: rootJobSchema }),
+    z.object({ kind: z.literal('abort'), requestId: z.number(), reason: z.enum(abortReasons) }),
+    z.object({ kind: z.literal('answer'), requestId: z.number(), value: z.unknown().optional(), problem: problemSchema.optional() }),
+    z.object({ kind: z.literal('stop') }),
+]);
+const summarySchema = z.object({
+    jobs: z.array(z.object({ name: z.string(), kind: z.enum(['command', 'query']), owner: z.string(), public: z.boolean(), retries: z.number().int(), syncOnly: z.boolean(), maxInputBytes: z.number().int() })),
+    handlers: z.array(z.object({ point: z.string(), extension: z.string(), retries: z.number().int() })),
+});
+// A sync job, root or nested, that ended failed or cancelled; the main thread queues the matching handler jobs.
+const syncEndSchema = z.object({ point: z.enum(['kernel.job.failed', 'kernel.job.cancelled']), input: z.record(z.string(), z.unknown()), workspaceId: z.string() });
+export const toMainSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('ready'), summary: summarySchema }),
+    z.object({ kind: z.literal('failed'), problem: problemSchema }),
+    z.object({ kind: z.literal('result'), requestId: z.number(), output: z.unknown() }),
+    z.object({ kind: z.literal('problem'), requestId: z.number(), problem: problemSchema }),
+    z.object({ kind: z.literal('request'), requestId: z.number(), request: workerRequestSchema }),
+    z.object({ kind: z.literal('progress'), rootId: z.string(), chunk: z.object({ source: z.string(), data: jsonSchema }) }),
+    z.object({ kind: z.literal('sync-ended'), end: syncEndSchema }),
+]);
+//# sourceMappingURL=protocol.js.map

package/dist/workers/protocol.js.map

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

package/dist/workers/root-runner.d.ts

@@ -0,0 +1,15 @@
+import { type JobEnvironment } from '../jobs/run-job.ts';
+import type { AbortReason, RootJob, ToMain, ToWorker } from './protocol.ts';
+export declare function createRootRunner(environment: JobEnvironment, send: (message: ToMain) => void): {
+    run: (requestId: number, job: RootJob) => void;
+    abort: (requestId: number, reason: AbortReason) => void;
+};
+type Answers = Map<number, {
+    resolve: (value: unknown) => void;
+    reject: (error: Error) => void;
+}>;
+export declare function answerFromMain(answers: Answers, message: Extract<ToWorker, {
+    kind: 'answer';
+}>): void;
+export {};
+//# sourceMappingURL=root-runner.d.ts.map

package/dist/workers/root-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-runner.d.ts","sourceRoot":"","sources":["../../src/workers/root-runner.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAiB5E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;qBAyBxE,MAAM,OAAO,OAAO,KAAG,IAAI;uBAGzB,MAAM,UAAU,WAAW,KAAG,IAAI;EAOxD;AAED,KAAK,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAAE,CAAC,CAAC;AAElG,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CAKrG"}

package/dist/workers/root-runner.js

@@ -0,0 +1,63 @@
+import { ProblemError } from '@kvman/sdk';
+import { runJob, syncEndOf } from "../jobs/run-job.js";
+import { kernelProblem } from "../problems.js";
+function abortProblem(reason) {
+    return reason === 'cancel' ? kernelProblem('CANCELLED', 'The job was cancelled.') : kernelProblem('INTERRUPTED', 'kvman stopped during the attempt.');
+}
+function problemAfter(root, problem) {
+    if (root.reason === 'cancel')
+        return abortProblem('cancel').problem;
+    if (root.reason === 'shutdown' && problem !== undefined)
+        return abortProblem('shutdown').problem;
+    return problem;
+}
+export function createRootRunner(environment, send) {
+    const roots = new Map();
+    const runRoot = async (requestId, job) => {
+        const root = { controller: new AbortController(), reason: undefined };
+        roots.set(requestId, root);
+        const request = { ...job, rootId: job.id, parent: undefined, signal: root.controller.signal, handlerExtension: job.handlerExtension };
+        let output;
+        let failure;
+        try {
+            output = await runJob(environment, request);
+        }
+        catch (error) {
+            if (!(error instanceof ProblemError))
+                throw error;
+            failure = error.problem;
+        }
+        finally {
+            roots.delete(requestId);
+        }
+        const problem = problemAfter(root, failure);
+        if (problem === undefined) {
+            send({ kind: 'result', requestId, output });
+            return;
+        }
+        if (!job.async && !job.fromHandler)
+            environment.reportSyncEnd(syncEndOf(request, problem, 'cancel'));
+        send({ kind: 'problem', requestId, problem });
+    };
+    return {
+        run: (requestId, job) => {
+            void runRoot(requestId, job);
+        },
+        abort: (requestId, reason) => {
+            const root = roots.get(requestId);
+            if (root === undefined || root.reason !== undefined)
+                return;
+            root.reason = reason;
+            root.controller.abort(abortProblem(reason));
+        },
+    };
+}
+export function answerFromMain(answers, message) {
+    const pending = answers.get(message.requestId);
+    answers.delete(message.requestId);
+    if (message.problem === undefined)
+        pending?.resolve(message.value);
+    else
+        pending?.reject(new ProblemError(message.problem));
+}
+//# sourceMappingURL=root-runner.js.map

package/dist/workers/root-runner.js.map

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

package/dist/workers/sdk-resolution.d.ts

@@ -0,0 +1,2 @@
+export declare function shareKernelSdk(): void;
+//# sourceMappingURL=sdk-resolution.d.ts.map

package/dist/workers/sdk-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-resolution.d.ts","sourceRoot":"","sources":["../../src/workers/sdk-resolution.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,IAAI,IAAI,CASrC"}

package/dist/workers/sdk-resolution.js

@@ -0,0 +1,14 @@
+import { registerHooks } from 'node:module';
+// Every `@kvman/sdk` import in a worker resolves to the kernel's own copy, so all extensions share one SDK and one zod
+// (plan 02 §2.9), whatever their own node_modules hold.
+export function shareKernelSdk() {
+    registerHooks({
+        resolve: (specifier, context, nextResolve) => {
+            if (specifier === '@kvman/sdk' || specifier.startsWith('@kvman/sdk/')) {
+                return nextResolve(specifier, { ...context, parentURL: import.meta.url });
+            }
+            return nextResolve(specifier, context);
+        },
+    });
+}
+//# sourceMappingURL=sdk-resolution.js.map

package/dist/workers/sdk-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-resolution.js","sourceRoot":"","sources":["../../src/workers/sdk-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,uHAAuH;AACvH,wDAAwD;AACxD,MAAM,UAAU,cAAc;IAC5B,aAAa,CAAC;QACZ,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE;YAC3C,IAAI,SAAS,KAAK,YAAY,IAAI,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtE,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/workers/worker-main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-main.d.ts.map

package/dist/workers/worker-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-main.d.ts","sourceRoot":"","sources":["../../src/workers/worker-main.ts"],"names":[],"mappings":""}

package/dist/workers/worker-main.js

@@ -0,0 +1,123 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { parentPort, workerData } from 'node:worker_threads';
+import { ProblemError } from '@kvman/sdk';
+import { systemClock } from "../clock.js";
+import { createExtensionCtx } from "../ctx/extension-ctx.js";
+import { createFiles } from "../files/files.js";
+import { handlerSummaries } from "../jobs/handlers.js";
+import { createIdGenerator } from "../ids.js";
+import { createRegistry } from "../jobs/registry.js";
+import { registerKernelApi } from "../kernel-api/register-kernel-api.js";
+import { openLogFile } from "../logging/log-file.js";
+import { kernelProblem } from "../problems.js";
+import { openSecretsFile } from "../secrets/secrets-file.js";
+import { kernelSettingDefinitions } from "../settings/kernel-settings.js";
+import { checkPresetSettings } from "../settings/preset-check.js";
+import { createSettings } from "../settings/settings.js";
+import { openConnection } from "../storage/database.js";
+import { answerFromMain, createRootRunner } from "./root-runner.js";
+import { shareKernelSdk } from "./sdk-resolution.js";
+import { toWorkerSchema, workerSetupSchema } from "./protocol.js";
+// A worker thread: it loads every extension of the run, then runs the jobs the main thread sends it (plan 02 §2.2).
+shareKernelSdk();
+if (parentPort === null)
+    throw new Error('worker-main runs only as a worker thread');
+const port = parentPort;
+const setup = workerSetupSchema.parse(workerData);
+// A handler sees the main thread's `process.argv`, so `process.argv[1]` is kvman's entry file (ADR 0009, 114).
+process.argv.splice(0, process.argv.length, ...setup.mainArgv);
+const send = (message) => port.postMessage(message);
+const logFile = openLogFile(setup.home, setup.logLevel, setup.terminalLog);
+const registry = createRegistry();
+for (const definition of kernelSettingDefinitions(setup.languages))
+    registry.settings.set(definition.key, definition);
+const answers = new Map();
+let nextRequest = 0;
+const connection = openConnection(setup.database);
+const ids = createIdGenerator(systemClock);
+const services = {
+    environment: { registry, logger: logFile.logger, reportSyncEnd: (end) => send({ kind: 'sync-ended', end }) },
+    ids,
+    request: (request) => new Promise((resolve, reject) => {
+        nextRequest += 1;
+        answers.set(nextRequest, { resolve, reject });
+        send({ kind: 'request', requestId: nextRequest, request });
+    }),
+    home: setup.home,
+    connection,
+    files: createFiles({ connection, home: setup.home, ids, clock: systemClock }),
+    logger: logFile.logger,
+    settings: createSettings({ connection, definitions: registry.settings, presetValues: setup.presetSettings, logger: logFile.logger }),
+    secrets: openSecretsFile(setup.home),
+    sendProgress: (rootId, chunk) => send({ kind: 'progress', rootId, chunk }),
+};
+const roots = createRootRunner(services.environment, send);
+// The worker closes its own connection and log before it exits, so SQLite never sees a thread torn down under it.
+function stop() {
+    connection.close();
+    logFile.close();
+    process.exit(0);
+}
+function isEntry(value) {
+    return typeof value === 'function';
+}
+async function loadExtension(extension) {
+    const module = await import(__rewriteRelativeImportExtension(extension.entryUrl));
+    const entry = typeof module === 'object' && module !== null && 'default' in module ? module.default : undefined;
+    if (!isEntry(entry))
+        throw kernelProblem('EXTENSION_INVALID', `${extension.name}: its entry doesn't default-export a function.`, { extension: extension.name });
+    entry(createExtensionCtx({ name: extension.name, namespace: extension.namespace }, services));
+}
+function loadProblem(extension, error) {
+    if (error instanceof ProblemError && error.problem.code === 'EXTENSION_INVALID')
+        return error.problem;
+    const reason = error instanceof Error ? error.message : String(error);
+    return { code: 'EXTENSION_INVALID', message: `${extension.name}: its entry failed (${reason}).`, params: { extension: extension.name } };
+}
+async function load() {
+    const { homeFolder, extensions } = setup;
+    registerKernelApi(registry, { ...services, homeFolder, registry, extensions });
+    for (const extension of setup.extensions) {
+        try {
+            await loadExtension(extension);
+        }
+        catch (error) {
+            send({ kind: 'failed', problem: loadProblem(extension, error) });
+            return;
+        }
+    }
+    registry.sealed = true;
+    if (setup.checkPresetSettings) {
+        try {
+            checkPresetSettings(registry.settings, setup.presetSettings);
+        }
+        catch (error) {
+            if (!(error instanceof ProblemError))
+                throw error;
+            send({ kind: 'failed', problem: error.problem });
+            return;
+        }
+    }
+    const jobs = [...registry.jobs.values()].map((job) => ({ name: job.name, kind: job.kind, owner: job.owner, public: job.public, retries: job.retries, syncOnly: job.syncOnly, maxInputBytes: job.maxInputBytes }));
+    send({ kind: 'ready', summary: { jobs, handlers: handlerSummaries(registry) } });
+}
+port.on('message', (raw) => {
+    const message = toWorkerSchema.parse(raw);
+    if (message.kind === 'run')
+        roots.run(message.requestId, message.job);
+    else if (message.kind === 'abort')
+        roots.abort(message.requestId, message.reason);
+    else if (message.kind === 'answer')
+        answerFromMain(answers, message);
+    else
+        stop();
+});
+await load();
+//# sourceMappingURL=worker-main.js.map

package/dist/workers/worker-main.js.map

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

package/dist/workspaces/workspaces.d.ts

@@ -0,0 +1,17 @@
+import type { Workspace } from '@kvman/sdk';
+import type { IdGenerator } from '../ids.ts';
+import type { Connection } from '../storage/database.ts';
+export declare const homeWorkspaceId = "home";
+export type ClosedWorkspaces = () => readonly string[];
+export declare function outsideClosed(joiner: 'WHERE' | 'AND', closed: readonly string[]): string;
+export declare function homeWorkspace(homeFolder: string): Workspace;
+export declare function openWorkspaceOf(connection: Connection, homeFolder: string, id: string): Workspace;
+export declare function listWorkspaces(connection: Connection, homeFolder: string): Workspace[];
+export type Workspaces = ReturnType<typeof createWorkspaces>;
+export declare function createWorkspaces(connection: Connection, homeFolder: string, ids: IdGenerator): {
+    closed: () => readonly string[];
+    open(folder: string, firstOpened: (workspaceId: string) => void): Workspace;
+    close(id: string): void;
+    openHomeFirstTime(firstOpened: (workspaceId: string) => void): void;
+};
+//# sourceMappingURL=workspaces.d.ts.map

package/dist/workspaces/workspaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/workspaces/workspaces.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,eAAO,MAAM,eAAe,SAAS,CAAC;AAItC,MAAM,MAAM,gBAAgB,GAAG,MAAM,SAAS,MAAM,EAAE,CAAC;AAIvD,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExF;AAID,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAE3D;AAGD,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAKjG;AAGD,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,CAGtF;AAeD,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW;kBAG7E,SAAS,MAAM,EAAE;iBAGhB,MAAM,eAAe,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS;cAgBjE,MAAM,GAAG,IAAI;mCAOQ,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;EAOtE"}

package/dist/workspaces/workspaces.js

@@ -0,0 +1,85 @@
+import { realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { kernelProblem } from "../problems.js";
+// Workspaces (plan 02 §2.6, ADR 0009, 22): folders on disk, remembered across restarts. Home, the user's home folder,
+// is built in and always open; closing another pauses it, and opening its path again brings back its id and data.
+export const homeWorkspaceId = 'home';
+// The SQL clause, joined by `WHERE` or `AND`, that leaves out rows of closed workspaces, with their ids as its
+// parameters; with none closed it is empty, so the common case costs nothing.
+export function outsideClosed(joiner, closed) {
+    return closed.length === 0 ? '' : ` ${joiner} workspace_id NOT IN (${closed.map(() => '?').join(', ')})`;
+}
+export function homeWorkspace(homeFolder) {
+    return { id: homeWorkspaceId, name: path.basename(homeFolder), path: homeFolder };
+}
+// The open workspace with this id; a closed or unknown one fails NOT_FOUND.
+export function openWorkspaceOf(connection, homeFolder, id) {
+    if (id === homeWorkspaceId)
+        return homeWorkspace(homeFolder);
+    const row = connection.prepare('SELECT id, name, path FROM workspaces WHERE id = ? AND open = 1').get(id);
+    if (row === undefined)
+        throw kernelProblem('NOT_FOUND', `There is no open workspace ${id}.`, { workspaceId: id });
+    return row;
+}
+// Home, then the open workspaces in the order they were first opened (their ids are UUIDv7).
+export function listWorkspaces(connection, homeFolder) {
+    const others = connection.prepare('SELECT id, name, path FROM workspaces WHERE open = 1 ORDER BY id').all();
+    return [homeWorkspace(homeFolder), ...others];
+}
+function realFolder(folder) {
+    if (!path.isAbsolute(folder))
+        throw kernelProblem('VALIDATION_FAILED', 'A workspace path must be absolute.', { path: folder });
+    let isFolder;
+    try {
+        isFolder = statSync(folder).isDirectory();
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw kernelProblem('VALIDATION_FAILED', `The workspace path can't be read (${reason}).`, { path: folder });
+    }
+    if (!isFolder)
+        throw kernelProblem('VALIDATION_FAILED', 'A workspace path must be a folder.', { path: folder });
+    return realpathSync.native(folder);
+}
+export function createWorkspaces(connection, homeFolder, ids) {
+    const closed = new Set(connection.prepare('SELECT id FROM workspaces WHERE open = 0').all().map((row) => row.id));
+    return {
+        closed: () => [...closed],
+        // Opens a folder: Home for Home's own folder, the existing workspace for an open path, the remembered one for a
+        // closed path, or a new one; `firstOpened` runs in the same transaction as a new workspace's row.
+        open(folder, firstOpened) {
+            const real = realFolder(folder);
+            if (real === realpathSync.native(homeFolder))
+                return homeWorkspace(homeFolder);
+            return connection.transaction(() => {
+                const row = connection.prepare('SELECT * FROM workspaces WHERE path = ?').get(real);
+                if (row !== undefined) {
+                    connection.prepare('UPDATE workspaces SET open = 1 WHERE id = ?').run(row.id);
+                    closed.delete(row.id);
+                    return { id: row.id, name: row.name, path: row.path };
+                }
+                const workspace = { id: ids(), name: path.basename(real), path: real };
+                connection.prepare('INSERT INTO workspaces (id, name, path, open) VALUES (?, ?, ?, 1)').run(workspace.id, workspace.name, workspace.path);
+                firstOpened(workspace.id);
+                return workspace;
+            })();
+        },
+        close(id) {
+            if (id === homeWorkspaceId)
+                throw kernelProblem('VALIDATION_FAILED', "Home can't be closed.", { workspaceId: id });
+            const changed = connection.prepare('UPDATE workspaces SET open = 0 WHERE id = ? AND open = 1').run(id).changes;
+            if (changed === 0)
+                throw kernelProblem('NOT_FOUND', `There is no open workspace ${id}.`, { workspaceId: id });
+            closed.add(id);
+        },
+        // Home counts as first opened on the first start of a new home (plan 02 §2.15).
+        openHomeFirstTime(firstOpened) {
+            connection.transaction(() => {
+                const marked = connection.prepare("INSERT INTO kernel_state (key, value) VALUES ('home-opened', 'true') ON CONFLICT DO NOTHING").run().changes;
+                if (marked === 1)
+                    firstOpened(homeWorkspaceId);
+            })();
+        },
+    };
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/workspaces/workspaces.js.map

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

package/locales/ar.json

@@ -0,0 +1,70 @@
+{
+  "kernel.errors.VALIDATION_FAILED": "هناك قيمة غير صالحة.",
+  "kernel.errors.NOT_FOUND": "العنصر المطلوب غير موجود.",
+  "kernel.errors.NOT_PUBLIC": "هذا خاص بإضافة أخرى.",
+  "kernel.errors.NOT_A_COMMAND": "الأوامر وحدها يمكن وضعها في قائمة الانتظار أو جدولتها.",
+  "kernel.errors.READ_ONLY": "الاستعلام للقراءة فقط.",
+  "kernel.errors.NO_JOB": "لا يعمل هذا إلا داخل مهمة جارية.",
+  "kernel.errors.TOO_LARGE": "تجاوز الحد المسموح به: {limit}.",
+  "kernel.errors.TOO_DEEP": "تداخل الاستدعاءات أعمق من الحد المسموح به: {limit}.",
+  "kernel.errors.TIMEOUT": "استغرق التنفيذ وقتًا أطول من المسموح.",
+  "kernel.errors.CANCELLED": "تم الإلغاء.",
+  "kernel.errors.WORKER_CRASHED": "توقف خيط العمل الذي كان ينفّذه بشكل غير متوقع.",
+  "kernel.errors.INTERRUPTED": "توقف kvman أثناء التنفيذ.",
+  "kernel.errors.HANDLER_FAILED": "فشل التنفيذ بشكل غير متوقع. التفاصيل في السجل.",
+  "kernel.errors.FORBIDDEN_ORIGIN": "هذا الطلب ليس صادرًا عن kvman.",
+  "kernel.errors.PROCESS_RUNNING": "توجد عملية بهذا الاسم تعمل بالفعل.",
+  "kernel.errors.PORT_IN_USE": "المنفذ مستخدم بالفعل.",
+  "kernel.errors.EXTENSION_INVALID": "تعذّر تحميل إحدى الإضافات.",
+  "kernel.errors.KVMAN_RUNNING": "kvman يعمل بالفعل على هذا المجلد الرئيسي.",
+  "kernel.port.description": "المنفذ الذي يستقبل عليه kvman الاتصالات. يُطبَّق عند التشغيل التالي.",
+  "kernel.workers.description": "عدد خيوط العمل التي تنفّذ المهام. يُطبَّق عند التشغيل التالي.",
+  "kernel.workerConcurrency.description": "عدد المهام التي ينفّذها خيط العمل الواحد في الوقت نفسه. يُطبَّق عند التشغيل التالي.",
+  "kernel.language.description": "لغة التطبيق.",
+  "kernel.jobs.retentionDays.description": "عدد الأيام التي تُحفظ فيها المهام المنتهية.",
+  "kernel.web.home.description": "الإضافة التي يفتح kvman تطبيق الويب الخاص بها.",
+  "kernel.workspace.open.description": "يفتح مجلدًا كمساحة عمل.",
+  "kernel.workspace.open.fields.path": "المجلد",
+  "kernel.workspace.close.description": "يغلق مساحة عمل؛ وتبقى بياناتها إلى أن تُفتح مجددًا.",
+  "kernel.workspace.close.fields.workspaceId": "مساحة العمل",
+  "kernel.workspace.list.description": "يسرد مساحات العمل المفتوحة.",
+  "kernel.folder.list.description": "يسرد المجلدات الفرعية لمجلد على هذا الجهاز.",
+  "kernel.folder.create.description": "ينشئ مجلدًا داخل مجلد على هذا الجهاز.",
+  "kernel.settings.set.description": "يضبط قيمة إعداد.",
+  "kernel.settings.set.fields.key": "الإعداد",
+  "kernel.settings.set.fields.value": "القيمة",
+  "kernel.settings.set.fields.scope": "النطاق",
+  "kernel.settings.reset.description": "يزيل قيمة إعداد في نطاق واحد.",
+  "kernel.settings.reset.fields.key": "الإعداد",
+  "kernel.settings.reset.fields.scope": "النطاق",
+  "kernel.settings.list.description": "يسرد كل الإعدادات مع قيمها.",
+  "kernel.secrets.set.description": "يضبط سرًّا لإحدى الإضافات.",
+  "kernel.secrets.set.fields.extension": "الإضافة",
+  "kernel.secrets.set.fields.name": "الاسم",
+  "kernel.secrets.set.fields.value": "القيمة",
+  "kernel.secrets.delete.description": "يحذف سرًّا لإحدى الإضافات.",
+  "kernel.secrets.delete.fields.extension": "الإضافة",
+  "kernel.secrets.delete.fields.name": "الاسم",
+  "kernel.secrets.list.description": "يسرد أسماء الأسرار، دون قيمها أبدًا.",
+  "kernel.jobs.get.description": "يعيد مهمة واحدة.",
+  "kernel.jobs.list.description": "يسرد مهام مساحة العمل الحالية، الأحدث أولًا.",
+  "kernel.files.get.description": "يعيد ملفًا من مساحة العمل الحالية.",
+  "kernel.files.list.description": "يسرد ملفات مساحة العمل الحالية، الأحدث أولًا.",
+  "kernel.files.unlink.description": "يحذف ملفًا من مساحة العمل الحالية.",
+  "kernel.files.unlink.fields.id": "الملف",
+  "kernel.extensions.list.description": "يسرد إضافات التشغيل الحالي وما تسجّله.",
+  "kernel.registrations.list.description": "يسرد كل أوامر التشغيل الحالي واستعلاماته مع مالك كلٍّ منها، دون المخططات.",
+  "kernel.preset.get.description": "يعيد الإعداد المسبق الحالي كما هو مخزَّن الآن.",
+  "kernel.extensions.install.description": "يضيف إضافة إلى ملف الإعداد المسبق؛ وتُطبَّق عند التشغيل التالي.",
+  "kernel.extensions.uninstall.description": "يزيل إضافة من ملف الإعداد المسبق؛ وتُطبَّق الإزالة عند التشغيل التالي.",
+  "kernel.restart.description": "يطلب من kvman إعادة التشغيل: يتوقف ثم يبدأ من جديد في العملية نفسها.",
+  "kernel.processes.list.description": "يسرد العمليات طويلة الأمد الجارية.",
+  "kernel.health.get.description": "يصف حالة kvman الجاري.",
+  "kernel.title": "kvman",
+  "kernel.port.title": "المنفذ",
+  "kernel.workers.title": "خيوط العمل",
+  "kernel.workerConcurrency.title": "المهام لكل خيط عمل",
+  "kernel.language.title": "اللغة",
+  "kernel.jobs.retentionDays.title": "مدة الاحتفاظ بالمهام المنتهية (بالأيام)",
+  "kernel.web.home.title": "تطبيق الويب"
+}