kvman 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Deif
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# kvman
+
+An app that works like a small operating system for every kind of user: a kernel runs extensions, and a preset shapes them into the app a person uses. Every feature is an extension, including the web UI and the AI agent.
+
+```
+npm i -g kvman
+kvman
+```
+
+kvman runs in the foreground on `127.0.0.1:3737` and opens the folder you start it from as a workspace. It needs Node.js 24, on Linux, macOS, or Windows.
+
+- [User guide](https://github.com/ibndeif/kvman/blob/main/docs/user-guide/README.md): install, connect a model, chat with the agent, manage settings.
+- [Developer documentation](https://github.com/ibndeif/kvman/blob/main/docs/developers/README.md): build extensions and presets.
+
+## License
+
+MIT

package/dist/arguments.d.ts

@@ -0,0 +1,20 @@
+import type { LogLevel } from '@kvman/kernel';
+export type RunArguments = {
+    kind: 'run';
+    mode: 'web' | undefined;
+    preset: string | undefined;
+    home: string | undefined;
+    port: number | undefined;
+    yes: boolean;
+    open: boolean;
+    logLevel: LogLevel;
+};
+export type CliArguments = {
+    kind: 'help';
+} | {
+    kind: 'version';
+} | RunArguments;
+export declare const usage = "Usage:\n  kvman [--mode web] [--preset coder] [--home <dir>] [--port <n>] [--yes] [--no-open] [--log-level <level>]\n  kvman --help | --version\n\nOptions:\n  --mode <mode>         How kvman runs: web (the default).\n  --preset <preset>     A bundled preset, <home>/presets/<name>.json, or a preset file such as ./app.json. Default: coder.\n  --home <dir>          kvman's home folder. Default: KVMAN_HOME, else ~/.kvman.\n  --port <n>            The port to listen on (0 picks a free one). Default: the kernel.port setting (3737).\n  --yes                 Accept new extension versions without asking.\n  --no-open             Don't open the browser.\n  --log-level <level>   debug, info (the default), warn, or error.\n  --help                Show this help.\n  --version             Show kvman's version.\n";
+export declare function parseArguments(argv: readonly string[]): CliArguments;
+export declare function kvmanHome(flag: string | undefined, environment: NodeJS.ProcessEnv, userFolder?: string): string;
+//# sourceMappingURL=arguments.d.ts.map

package/dist/arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../src/arguments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAAC;AAEjF,eAAO,MAAM,KAAK,8yBAcjB,CAAC;AA0CF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAcpE;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,GAAE,MAAqB,GAAG,MAAM,CAG7H"}

package/dist/arguments.js

@@ -0,0 +1,80 @@
+import os from 'node:os';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { ProblemError, z } from '@kvman/sdk';
+export const usage = `Usage:
+  kvman [--mode web] [--preset coder] [--home <dir>] [--port <n>] [--yes] [--no-open] [--log-level <level>]
+  kvman --help | --version
+
+Options:
+  --mode <mode>         How kvman runs: web (the default).
+  --preset <preset>     A bundled preset, <home>/presets/<name>.json, or a preset file such as ./app.json. Default: coder.
+  --home <dir>          kvman's home folder. Default: KVMAN_HOME, else ~/.kvman.
+  --port <n>            The port to listen on (0 picks a free one). Default: the kernel.port setting (3737).
+  --yes                 Accept new extension versions without asking.
+  --no-open             Don't open the browser.
+  --log-level <level>   debug, info (the default), warn, or error.
+  --help                Show this help.
+  --version             Show kvman's version.
+`;
+const flags = {
+    mode: { type: 'string' },
+    preset: { type: 'string' },
+    home: { type: 'string' },
+    port: { type: 'string' },
+    yes: { type: 'boolean' },
+    'no-open': { type: 'boolean' },
+    'log-level': { type: 'string' },
+    help: { type: 'boolean' },
+    version: { type: 'boolean' },
+};
+const modeSchema = z.literal('web', { error: 'The mode must be web.' }).optional();
+const logLevelSchema = z.enum(['debug', 'info', 'warn', 'error'], { error: 'The log level must be debug, info, warn, or error.' }).default('info');
+const portSchema = z
+    .string()
+    .regex(/^\d+$/, { error: 'The port must be a whole number from 0 to 65535.' })
+    .transform(Number)
+    .pipe(z.number().max(65_535, { error: 'The port must be a whole number from 0 to 65535.' }))
+    .optional();
+function invalid(message) {
+    return new ProblemError({ code: 'VALIDATION_FAILED', message });
+}
+function parsed(schema, value) {
+    const result = schema.safeParse(value);
+    if (!result.success)
+        throw invalid(result.error.issues.map((issue) => issue.message).join(' '));
+    return result.data;
+}
+function readFlags(argv) {
+    try {
+        return parseArgs({ args: [...argv], options: flags, strict: true, allowPositionals: false });
+    }
+    catch (error) {
+        if (error instanceof TypeError)
+            throw invalid(error.message);
+        throw error;
+    }
+}
+export function parseArguments(argv) {
+    const { values } = readFlags(argv);
+    if (values.help === true)
+        return { kind: 'help' };
+    if (values.version === true)
+        return { kind: 'version' };
+    return {
+        kind: 'run',
+        mode: parsed(modeSchema, values.mode),
+        preset: values.preset,
+        home: values.home,
+        port: parsed(portSchema, values.port),
+        yes: values.yes === true,
+        open: values['no-open'] !== true,
+        logLevel: parsed(logLevelSchema, values['log-level']),
+    };
+}
+// `--home`, else `KVMAN_HOME`, else `~/.kvman` (plan 01 §1.3).
+export function kvmanHome(flag, environment, userFolder = os.homedir()) {
+    const chosen = flag ?? environment['KVMAN_HOME'];
+    return chosen === undefined || chosen === '' ? path.join(userFolder, '.kvman') : path.resolve(chosen);
+}
+//# sourceMappingURL=arguments.js.map

package/dist/arguments.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,7 @@
+export type BrowserCommand = {
+    command: string;
+    args: string[];
+};
+export declare function browserCommand(platform: NodeJS.Platform, url: string): BrowserCommand;
+export declare function openBrowser(platform: NodeJS.Platform, url: string, failed: (reason: string) => void): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAIrF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAO1G"}

package/dist/browser.js

@@ -0,0 +1,18 @@
+import { spawn } from 'node:child_process';
+export function browserCommand(platform, url) {
+    if (platform === 'darwin')
+        return { command: 'open', args: [url] };
+    if (platform === 'win32')
+        return { command: 'cmd', args: ['/c', 'start', '""', url] };
+    return { command: 'xdg-open', args: [url] };
+}
+export function openBrowser(platform, url, failed) {
+    const { command, args } = browserCommand(platform, url);
+    const child = spawn(command, args, { stdio: 'ignore', windowsHide: true, windowsVerbatimArguments: platform === 'win32' });
+    child.once('error', (error) => failed(error.message));
+    child.once('exit', (code) => {
+        if (code !== 0)
+            failed(`${command} exited with code ${String(code)}`);
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C,MAAM,UAAU,cAAc,CAAC,QAAyB,EAAE,GAAW;IACnE,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAyB,EAAE,GAAW,EAAE,MAAgC;IAClG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAC3H,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,OAAO,qBAAqB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/bundled.d.ts

@@ -0,0 +1,3 @@
+export declare const bundledPresetsFolder: string;
+export declare function bundledExtensions(folder?: string): ReadonlyMap<string, string>;
+//# sourceMappingURL=bundled.d.ts.map

package/dist/bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled.d.ts","sourceRoot":"","sources":["../src/bundled.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,oBAAoB,QAAsC,CAAC;AASxE,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAsB,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAU7F"}

package/dist/bundled.js

@@ -0,0 +1,28 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from '@kvman/sdk';
+// What ships with kvman (plan 01 §1.4, ADR 0026): the bundled presets in the package's own `presets/`, and the bundled
+// extensions, which are the package's dependencies that have a `kvman` field. Each is found as Node resolves any
+// module, so the repository and an installed kvman take the same path.
+const packageFolder = fileURLToPath(new URL('../', import.meta.url));
+export const bundledPresetsFolder = path.join(packageFolder, 'presets');
+const packageSchema = z.object({ dependencies: z.record(z.string(), z.string()).optional() });
+const dependencySchema = z.object({ kvman: z.unknown().optional() });
+function readJson(file) {
+    return JSON.parse(readFileSync(file, 'utf8'));
+}
+export function bundledExtensions(folder = packageFolder) {
+    const manifestFile = path.join(folder, 'package.json');
+    const resolveFromPackage = createRequire(manifestFile).resolve;
+    const extensions = new Map();
+    for (const name of Object.keys(packageSchema.parse(readJson(manifestFile)).dependencies ?? {})) {
+        const dependencyManifest = resolveFromPackage(`${name}/package.json`);
+        if (dependencySchema.parse(readJson(dependencyManifest)).kvman === undefined)
+            continue;
+        extensions.set(name, path.dirname(dependencyManifest));
+    }
+    return extensions;
+}
+//# sourceMappingURL=bundled.js.map

package/dist/bundled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../src/bundled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,uHAAuH;AACvH,iHAAiH;AACjH,uEAAuE;AAEvE,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAExE,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC9F,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAErE,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,aAAa;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/F,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;QACtE,IAAI,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACvF,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/hand-over.d.ts

@@ -0,0 +1,11 @@
+import { type Workspace } from '@kvman/sdk';
+import type { Lock } from './lock-file.ts';
+export type GivenFlags = {
+    preset: string | undefined;
+    mode: 'web' | undefined;
+};
+export declare function handOver(lock: Lock, folder: string, given: GivenFlags): Promise<{
+    port: number;
+    workspace: Workspace;
+}>;
+//# sourceMappingURL=hand-over.d.ts.map

package/dist/hand-over.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hand-over.d.ts","sourceRoot":"","sources":["../src/hand-over.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6E,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACvH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAK3C,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,CAAC;AAgCjF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC,CAO7H"}

package/dist/hand-over.js

@@ -0,0 +1,40 @@
+import { envelopeSchema, healthSchema, ProblemError, workspaceSchema, z } from '@kvman/sdk';
+function running(lock, message, params = {}) {
+    return new ProblemError({ code: 'KVMAN_RUNNING', message, params: { pid: lock.pid, ...params } });
+}
+async function call(lock, port, route, input, output) {
+    let response;
+    try {
+        response = await fetch(`http://127.0.0.1:${String(port)}/api/${route}`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ input }),
+        });
+    }
+    catch {
+        throw running(lock, `Another kvman (pid ${String(lock.pid)}) holds this home's lock, but it doesn't answer on port ${String(port)}.`, { port });
+    }
+    const answer = envelopeSchema({ output, jobId: z.string() }).parse(await response.json());
+    if (!answer.ok)
+        throw new ProblemError(answer.problem);
+    return answer.output;
+}
+function checkFlags(lock, health, given) {
+    if (given.preset !== undefined && given.preset !== health.preset) {
+        throw running(lock, `Another kvman (pid ${String(lock.pid)}) runs the preset ${health.preset} on this home, not ${given.preset}.`, { preset: health.preset });
+    }
+    if (given.mode !== undefined && given.mode !== health.mode) {
+        throw running(lock, `Another kvman (pid ${String(lock.pid)}) runs in ${health.mode} mode on this home, not ${given.mode}.`, { mode: health.mode });
+    }
+}
+// Opens `folder` in the running kvman and returns its workspace and port.
+export async function handOver(lock, folder, given) {
+    const port = lock.port;
+    if (port === undefined)
+        throw running(lock, `Another kvman (pid ${String(lock.pid)}) is still starting on this home.`);
+    const health = await call(lock, port, 'queries/kernel.health.get', {}, healthSchema);
+    checkFlags(lock, health, given);
+    const workspace = await call(lock, port, 'commands/kernel.workspace.open', { path: folder }, workspaceSchema);
+    return { port, workspace };
+}
+//# sourceMappingURL=hand-over.js.map

package/dist/hand-over.js.map

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

package/dist/lock-file.d.ts

@@ -0,0 +1,19 @@
+import { z } from '@kvman/sdk';
+declare const lockSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    port: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Lock = z.infer<typeof lockSchema>;
+export type TakenLock = {
+    kind: 'taken';
+    setPort(port: number): void;
+    release(): void;
+};
+export type LockTaking = TakenLock | {
+    kind: 'held';
+    lock: Lock;
+};
+export declare function isAlive(pid: number): boolean;
+export declare function takeLock(home: string, pid?: number, alive?: (pid: number) => boolean): LockTaking;
+export {};
+//# sourceMappingURL=lock-file.d.ts.map

package/dist/lock-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.d.ts","sourceRoot":"","sources":["../src/lock-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAO/B,QAAA,MAAM,UAAU;;;iBAAuG,CAAC;AAExH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAMlE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAS5C;AA6DD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB,EAAE,KAAK,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAiB,GAAG,UAAU,CAUvH"}

package/dist/lock-file.js

@@ -0,0 +1,105 @@
+import { linkSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+// `kvman.lock` (plan 01 §1.3, ADR 0009, 43): `{ pid }` from start, `{ pid, port }` once kvman listens. A lock is only
+// ever put in place whole, by hard-linking a finished file (which fails when a lock exists). A stale lock is moved
+// aside before it's removed; if what was moved turns out to be another kvman's fresh lock, it's put back, so two kvmen
+// replacing one stale lock can't both take it.
+const lockSchema = z.object({ pid: z.number().int().positive(), port: z.number().int().min(1).max(65_535).optional() });
+function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (hasCode(error, 'ESRCH'))
+            return false;
+        if (hasCode(error, 'EPERM'))
+            return true;
+        throw error;
+    }
+}
+function readLock(file) {
+    try {
+        const text = readFileSync(file, 'utf8');
+        const result = lockSchema.safeParse(JSON.parse(text));
+        return { text, lock: result.success ? result.data : undefined };
+    }
+    catch (error) {
+        if (hasCode(error, 'ENOENT'))
+            return undefined;
+        if (error instanceof SyntaxError)
+            return { text: '', lock: undefined };
+        throw error;
+    }
+}
+// Writes a finished file beside the lock and links it into place; false when a lock is already there.
+function placeLock(file, lock) {
+    const draft = `${file}.${String(process.pid)}.draft`;
+    writeFileSync(draft, JSON.stringify(lock));
+    try {
+        linkSync(draft, file);
+        return true;
+    }
+    catch (error) {
+        if (hasCode(error, 'EEXIST'))
+            return false;
+        throw error;
+    }
+    finally {
+        rmSync(draft, { force: true });
+    }
+}
+function removeStale(file, staleText) {
+    const aside = `${file}.${String(process.pid)}.stale`;
+    try {
+        renameSync(file, aside);
+    }
+    catch (error) {
+        if (hasCode(error, 'ENOENT'))
+            return;
+        throw error;
+    }
+    if (readFileSync(aside, 'utf8') !== staleText) {
+        try {
+            linkSync(aside, file);
+        }
+        catch (error) {
+            if (!hasCode(error, 'EEXIST'))
+                throw error;
+        }
+    }
+    rmSync(aside, { force: true });
+}
+function taken(file, pid) {
+    return {
+        kind: 'taken',
+        setPort: (port) => {
+            const draft = `${file}.${String(pid)}.draft`;
+            writeFileSync(draft, JSON.stringify({ pid, port }));
+            renameSync(draft, file);
+        },
+        release: () => {
+            if (readLock(file)?.lock?.pid === pid)
+                rmSync(file, { force: true });
+        },
+    };
+}
+export function takeLock(home, pid = process.pid, alive = isAlive) {
+    mkdirSync(home, { recursive: true });
+    const file = path.join(home, 'kvman.lock');
+    for (;;) {
+        if (placeLock(file, { pid }))
+            return taken(file, pid);
+        const found = readLock(file);
+        if (found === undefined)
+            continue;
+        if (found.lock !== undefined && alive(found.lock.pid))
+            return { kind: 'held', lock: found.lock };
+        removeStale(file, found.text);
+    }
+}
+//# sourceMappingURL=lock-file.js.map

package/dist/lock-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.js","sourceRoot":"","sources":["../src/lock-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,sHAAsH;AACtH,mHAAmH;AACnH,uHAAuH;AACvH,+CAA+C;AAE/C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAQxH,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,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACvE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,SAAS,SAAS,CAAC,IAAY,EAAE,IAAU;IACzC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,SAAiB;IAClD,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrD,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO;QACrC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,KAAK,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,GAAW;IACtC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7C,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACpD,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG;gBAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE,QAAkC,OAAO;IACzG,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,SAAS,CAAC;QACR,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACjG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

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

package/dist/main.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import os from 'node:os';
+import { kernelVersion } from '@kvman/kernel';
+import { ProblemError } from '@kvman/sdk';
+import { parseArguments, usage } from "./arguments.js";
+import { runKvman } from "./run-kvman.js";
+import { failureLines } from "./terminal.js";
+// The `kvman` bin (plan 01 §1.2): 0 after a clean stop or a hand-over, 1 after a failed start (plan 02 §2.14), and 130
+// after a second Ctrl+C (ADR 0009, 50).
+async function main(argv) {
+    const args = parseArguments(argv);
+    if (args.kind === 'help') {
+        process.stdout.write(usage);
+        return 0;
+    }
+    if (args.kind === 'version') {
+        process.stdout.write(`${kernelVersion()}\n`);
+        return 0;
+    }
+    return runKvman(args, {
+        variables: process.env,
+        startFolder: process.cwd(),
+        userFolder: os.homedir(),
+        platform: process.platform,
+        terminal: { input: process.stdin, output: process.stdout, isTerminal: process.stdin.isTTY === true && process.stdout.isTTY === true },
+        errors: process.stderr,
+        exitAtOnce: (code) => process.exit(code),
+    });
+}
+main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (error) => {
+    process.stderr.write(error instanceof ProblemError ? failureLines(error.problem) : `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,uHAAuH;AACvH,wCAAwC;AAExC,KAAK,UAAU,IAAI,CAAC,IAAuB;IACzC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE;QACpB,SAAS,EAAE,OAAO,CAAC,GAAG;QACtB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;QAC1B,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE;QACrI,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnK,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/preset-lookup.d.ts

@@ -0,0 +1,18 @@
+import type { PresetSource } from '@kvman/kernel';
+import { type Preset } from '@kvman/sdk';
+export type PresetFolders = {
+    bundled: string;
+    home: string;
+    start: string;
+};
+export type FoundPreset = {
+    preset: Preset;
+    presetFolder: string;
+    source: PresetSource;
+};
+export declare const defaultPreset = "coder";
+export declare function isPresetFile(value: string): boolean;
+/** The file an edit of the preset `value` writes: the preset file given, or `<home>/presets/<name>.json` (ADR 0024, 5). */
+export declare function editableFile(value: string, folders: PresetFolders): string;
+export declare function findPreset(value: string, folders: PresetFolders): FoundPreset;
+//# sourceMappingURL=preset-lookup.d.ts.map

package/dist/preset-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-lookup.d.ts","sourceRoot":"","sources":["../src/preset-lookup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAOrE,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAEzF,eAAO,MAAM,aAAa,UAAU,CAAC;AAMrC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AA0BD,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAE1E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,CAM7E"}

package/dist/preset-lookup.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { presetSchema, ProblemError } from '@kvman/sdk';
+export const defaultPreset = 'coder';
+function invalid(message, params) {
+    return new ProblemError({ code: 'VALIDATION_FAILED', message, params });
+}
+export function isPresetFile(value) {
+    return value.includes('/') || value.includes('\\') || value.endsWith('.json');
+}
+function readPreset(file, source) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw invalid(`The preset ${file} can't be read (${reason}).`, { file });
+    }
+    const result = presetSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues.map((issue) => `${issue.path.join('.') || 'preset'}: ${issue.message}`).join('; ');
+        throw invalid(`The preset ${file} is invalid (${issues}).`, { file });
+    }
+    return { preset: result.data, presetFolder: path.dirname(file), source };
+}
+function namedPreset(name, folders) {
+    const own = path.join(folders.home, 'presets', `${name}.json`);
+    if (existsSync(own))
+        return readPreset(own, { origin: 'home', file: own });
+    const bundled = path.join(folders.bundled, `${name}.json`);
+    if (existsSync(bundled))
+        return readPreset(bundled, { origin: 'bundled' });
+    throw invalid(`There is no preset named ${name}: neither a bundled one nor ${own}.`, { preset: name });
+}
+/** The file an edit of the preset `value` writes: the preset file given, or `<home>/presets/<name>.json` (ADR 0024, 5). */
+export function editableFile(value, folders) {
+    return isPresetFile(value) ? path.resolve(folders.start, value) : path.join(folders.home, 'presets', `${value}.json`);
+}
+export function findPreset(value, folders) {
+    if (isPresetFile(value)) {
+        const file = path.resolve(folders.start, value);
+        return readPreset(file, { origin: 'file', file });
+    }
+    return namedPreset(value, folders);
+}
+//# sourceMappingURL=preset-lookup.js.map

package/dist/preset-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-lookup.js","sourceRoot":"","sources":["../src/preset-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAWrE,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,SAAS,OAAO,CAAC,OAAe,EAAE,MAA8B;IAC9D,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,MAAoB;IACpD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,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,cAAc,IAAI,mBAAmB,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtH,MAAM,OAAO,CAAC,cAAc,IAAI,gBAAgB,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAsB;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,CAAC,4BAA4B,IAAI,+BAA+B,GAAG,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,2HAA2H;AAC3H,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAsB;IAChE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;AACxH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAAsB;IAC9D,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/run-kvman.d.ts

@@ -0,0 +1,13 @@
+import { type RunArguments } from './arguments.ts';
+import type { Terminal } from './trust-prompt.ts';
+export type CliEnvironment = {
+    variables: NodeJS.ProcessEnv;
+    startFolder: string;
+    userFolder: string;
+    platform: NodeJS.Platform;
+    terminal: Terminal;
+    errors: NodeJS.WritableStream;
+    exitAtOnce: (code: number) => never;
+};
+export declare function runKvman(args: RunArguments, environment: CliEnvironment): Promise<number>;
+//# sourceMappingURL=run-kvman.d.ts.map

package/dist/run-kvman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-kvman.d.ts","sourceRoot":"","sources":["../src/run-kvman.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAMlD,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CACrC,CAAC;AA2CF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB/F"}

package/dist/run-kvman.js

@@ -0,0 +1,70 @@
+import { discardPresetBackup, startHttp } from '@kvman/kernel';
+import { kvmanHome } from "./arguments.js";
+import { openBrowser } from "./browser.js";
+import { bundledPresetsFolder } from "./bundled.js";
+import { handOver } from "./hand-over.js";
+import { takeLock } from "./lock-file.js";
+import { defaultPreset, editableFile, findPreset } from "./preset-lookup.js";
+import { startOrUndo } from "./start-kernel.js";
+import { listenForStop } from "./stop-signals.js";
+function workspaceUrl(port, workspaceId) {
+    return `http://127.0.0.1:${String(port)}/?workspace=${encodeURIComponent(workspaceId)}`;
+}
+async function joinRunning(args, lock, folders, environment) {
+    const preset = args.preset === undefined ? undefined : findPreset(args.preset, folders).preset.name;
+    const { port, workspace } = await handOver(lock, environment.startFolder, { preset, mode: args.mode });
+    const url = workspaceUrl(port, workspace.id);
+    environment.terminal.output.write(`kvman is already running; this folder is open at ${url}\n`);
+    if (args.open)
+        openBrowser(environment.platform, url, (reason) => environment.errors.write(`The browser could not be opened (${reason}).\n`));
+    return 0;
+}
+// A good start (the port is listening) deletes the backup of the last edit (ADR 0024, 4).
+async function serve(args, kernel, lock, environment, run) {
+    const stop = listenForStop(() => {
+        lock.release();
+        environment.exitAtOnce(130);
+    });
+    try {
+        const http = await startHttp(kernel, { port: args.port ?? kernel.web.port() }).catch(async (error) => {
+            await kernel.close();
+            throw error;
+        });
+        lock.setPort(http.port);
+        discardPresetBackup(run.presetFile);
+        const url = workspaceUrl(http.port, kernel.startWorkspace.id);
+        environment.terminal.output.write(`kvman is running at ${url}\n`);
+        if (run.open)
+            openBrowser(environment.platform, url, (reason) => kernel.web.logger.warn('The browser could not be opened.', { reason }));
+        const requested = await Promise.race([stop.stopRequested.then(() => 'stopped'), kernel.restartRequested.then(() => 'restart')]);
+        const closing = http.close();
+        await kernel.close();
+        await closing;
+        return stop.isRequested() ? 'stopped' : requested;
+    }
+    finally {
+        stop.dispose();
+    }
+}
+export async function runKvman(args, environment) {
+    const home = kvmanHome(args.home, environment.variables, environment.userFolder);
+    const folders = { bundled: bundledPresetsFolder, home, start: environment.startFolder };
+    const lock = takeLock(home);
+    if (lock.kind === 'held')
+        return joinRunning(args, lock.lock, folders, environment);
+    // A program kvman runs (kvcustomizer's `kvman-docs`) finds this kvman through `<home>/kvman.lock` (plan 01 §1.2).
+    process.env['KVMAN_HOME'] = home;
+    const presetFile = editableFile(args.preset ?? defaultPreset, folders);
+    try {
+        for (let open = args.open;; open = false) {
+            const kernel = await startOrUndo(args, folders, environment);
+            if ((await serve(args, kernel, lock, environment, { open, presetFile })) === 'stopped')
+                return 0;
+            environment.terminal.output.write('kvman is restarting…\n');
+        }
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=run-kvman.js.map

package/dist/run-kvman.js.map

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

package/dist/start-kernel.d.ts

@@ -0,0 +1,6 @@
+import { type Kernel } from '@kvman/kernel';
+import type { RunArguments } from './arguments.ts';
+import type { CliEnvironment } from './run-kvman.ts';
+import { type PresetFolders } from './preset-lookup.ts';
+export declare function startOrUndo(args: RunArguments, folders: PresetFolders, environment: CliEnvironment): Promise<Kernel>;
+//# sourceMappingURL=start-kernel.d.ts.map

package/dist/start-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-kernel.d.ts","sourceRoot":"","sources":["../src/start-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA4BjG,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1H"}

package/dist/start-kernel.js

@@ -0,0 +1,41 @@
+import { restorePresetBackup, startKernel } from '@kvman/kernel';
+import { ProblemError } from '@kvman/sdk';
+import { bundledExtensions } from "./bundled.js";
+import { defaultPreset, editableFile, findPreset } from "./preset-lookup.js";
+import { failureLines } from "./terminal.js";
+import { trustDecision } from "./trust-prompt.js";
+// Starting the kernel for a run (plan 02 §2.14, ADR 0024, 5): a start that fails because of the preset, while the
+// backup of the last edit exists, restores the preset and starts once more.
+// The failures that a preset edit can cause; `PORT_IN_USE` and the like are not undone by restoring a file.
+const undoable = new Set(['EXTENSION_INVALID', 'VALIDATION_FAILED']);
+function startOnce(args, folders, environment, rolledBack) {
+    const found = findPreset(args.preset ?? defaultPreset, folders);
+    return startKernel({
+        home: folders.home,
+        homeFolder: environment.userFolder,
+        preset: found.preset,
+        presetFolder: found.presetFolder,
+        presetSource: found.source,
+        bundled: bundledExtensions(),
+        mode: args.mode ?? 'web',
+        logLevel: args.logLevel,
+        terminalLog: true,
+        startFolder: environment.startFolder,
+        trust: trustDecision(args.yes, environment.terminal),
+        ...(rolledBack === undefined ? {} : { rolledBack }),
+    });
+}
+export async function startOrUndo(args, folders, environment) {
+    try {
+        return await startOnce(args, folders, environment, undefined);
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError) || !undoable.has(error.problem.code))
+            throw error;
+        if (!restorePresetBackup(editableFile(args.preset ?? defaultPreset, folders)))
+            throw error;
+        environment.errors.write(`${failureLines(error.problem)}The last change to the preset was undone.\n`);
+        return startOnce(args, folders, environment, error.problem);
+    }
+}
+//# sourceMappingURL=start-kernel.js.map

package/dist/start-kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-kernel.js","sourceRoot":"","sources":["../src/start-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAsB,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,kHAAkH;AAClH,4EAA4E;AAE5E,4GAA4G;AAC5G,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAE1F,SAAS,SAAS,CAAC,IAAkB,EAAE,OAAsB,EAAE,WAA2B,EAAE,UAA+B;IACzH,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,MAAM;QAC1B,OAAO,EAAE,iBAAiB,EAAE;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC;QACpD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB,EAAE,OAAsB,EAAE,WAA2B;IACvG,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC;QACvF,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,EAAE,OAAO,CAAC,CAAC;YAAE,MAAM,KAAK,CAAC;QAC3F,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;QACtG,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/stop-signals.d.ts

@@ -0,0 +1,7 @@
+export type StopSignals = {
+    stopRequested: Promise<void>;
+    isRequested(): boolean;
+    dispose(): void;
+};
+export declare function listenForStop(atOnce: () => void): StopSignals;
+//# sourceMappingURL=stop-signals.d.ts.map

package/dist/stop-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-signals.d.ts","sourceRoot":"","sources":["../src/stop-signals.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IAAE,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,WAAW,IAAI,OAAO,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAEpG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,WAAW,CAsB7D"}

package/dist/stop-signals.js

@@ -0,0 +1,29 @@
+// Ctrl+C and SIGTERM (plan 02 §2.14, ADR 0009, 50): the first signal starts the stop sequence; a second one stops at
+// once through `atOnce`.
+const signals = ['SIGINT', 'SIGTERM'];
+export function listenForStop(atOnce) {
+    let requested = false;
+    let request = () => undefined;
+    const stopRequested = new Promise((resolve) => {
+        request = resolve;
+    });
+    const onSignal = () => {
+        if (requested) {
+            atOnce();
+            return;
+        }
+        requested = true;
+        request();
+    };
+    for (const signal of signals)
+        process.on(signal, onSignal);
+    return {
+        stopRequested,
+        isRequested: () => requested,
+        dispose: () => {
+            for (const signal of signals)
+                process.off(signal, onSignal);
+        },
+    };
+}
+//# sourceMappingURL=stop-signals.js.map

package/dist/stop-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-signals.js","sourceRoot":"","sources":["../src/stop-signals.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,yBAAyB;AAEzB,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAI/C,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClD,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,OAAO;QACL,aAAa;QACb,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;QAC5B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/terminal.d.ts

@@ -0,0 +1,3 @@
+import type { Problem } from '@kvman/sdk';
+export declare function failureLines(problem: Problem): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAc1C,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAErD"}

package/dist/terminal.js

@@ -0,0 +1,13 @@
+// A failed start on the terminal (plan 02 §2.14, ADR 0009, 49): the Problem as `CODE: message`, then a hint for its
+// code, in English.
+const hints = new Map([
+    ['KVMAN_RUNNING', 'Use the kvman already running on this home, stop it, or start with --home <dir>. If it is still starting, try again once it has started.'],
+    ['PORT_IN_USE', 'Stop what uses the port, or start with --port <n> (0 picks a free one).'],
+    ['EXTENSION_INVALID', 'Fix the extension or remove it from the preset. New extension versions need a y at the prompt, or --yes.'],
+    ['VALIDATION_FAILED', 'Check the flags (kvman --help), the preset, and its settings.'],
+]);
+const fallbackHint = 'See logs/kvman.log in the kvman home for details.';
+export function failureLines(problem) {
+    return `${problem.code}: ${problem.message}\n${hints.get(problem.code) ?? fallbackHint}\n`;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAEA,oHAAoH;AACpH,oBAAoB;AAEpB,MAAM,KAAK,GAAgC,IAAI,GAAG,CAAC;IACjD,CAAC,eAAe,EAAE,0IAA0I,CAAC;IAC7J,CAAC,aAAa,EAAE,yEAAyE,CAAC;IAC1F,CAAC,mBAAmB,EAAE,0GAA0G,CAAC;IACjI,CAAC,mBAAmB,EAAE,+DAA+D,CAAC;CACvF,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,mDAAmD,CAAC;AAEzE,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC;AAC7F,CAAC"}

package/dist/trust-prompt.d.ts

@@ -0,0 +1,8 @@
+import type { TrustDecision } from '@kvman/kernel';
+export type Terminal = {
+    input: NodeJS.ReadableStream;
+    output: NodeJS.WritableStream;
+    isTerminal: boolean;
+};
+export declare function trustDecision(yes: boolean, terminal: Terminal): TrustDecision;
+//# sourceMappingURL=trust-prompt.d.ts.map

package/dist/trust-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-prompt.d.ts","sourceRoot":"","sources":["../src/trust-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,eAAe,CAAC;AAMrE,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAc5G,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAS7E"}

package/dist/trust-prompt.js

@@ -0,0 +1,25 @@
+import { createInterface } from 'node:readline';
+function ask(terminal, question) {
+    const lines = createInterface({ input: terminal.input, output: terminal.output });
+    return new Promise((resolve) => {
+        lines.once('close', () => resolve(''));
+        lines.once('SIGINT', () => lines.close());
+        lines.question(question, (answer) => {
+            resolve(answer);
+            lines.close();
+        });
+    });
+}
+export function trustDecision(yes, terminal) {
+    return async (versions) => {
+        if (yes)
+            return true;
+        if (!terminal.isTerminal)
+            return false;
+        const listed = versions.map((version) => `  ${version.name}@${version.version} (${version.source})\n`).join('');
+        terminal.output.write(`These extension versions haven't been accepted before:\n${listed}`);
+        const answer = await ask(terminal, 'Load them? [y/N] ');
+        return answer.trim().toLowerCase() === 'y';
+    };
+}
+//# sourceMappingURL=trust-prompt.js.map

package/dist/trust-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-prompt.js","sourceRoot":"","sources":["../src/trust-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAShD,SAAS,GAAG,CAAC,QAAkB,EAAE,QAAgB;IAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAClC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,QAAkB;IAC5D,OAAO,KAAK,EAAE,QAAqC,EAAE,EAAE;QACrD,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChH,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,2DAA2D,MAAM,EAAE,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;IAC7C,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "kvman",
+  "version": "0.1.0",
+  "description": "kvman, an app that works like a small operating system: a kernel runs extensions, and a preset shapes them.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ibndeif/kvman.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/ibndeif/kvman#readme",
+  "bugs": {
+    "url": "https://github.com/ibndeif/kvman/issues"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "presets"
+  ],
+  "bin": {
+    "kvman": "./dist/main.js"
+  },
+  "dependencies": {
+    "@kvman/kernel": "0.1.0",
+    "@kvman/kvai": "0.1.0",
+    "@kvman/kvcoder": "0.1.0",
+    "@kvman/kvcustomizer": "0.1.0",
+    "@kvman/kvwebui": "0.1.0",
+    "@kvman/sdk": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}

package/presets/coder.json

@@ -0,0 +1,14 @@
+{
+  "name": "coder",
+  "extensions": {
+    "@kvman/kvai": "bundled",
+    "@kvman/kvwebui": "bundled",
+    "@kvman/kvcoder": "bundled",
+    "@kvman/kvcustomizer": "bundled"
+  },
+  "settings": {
+    "kvwebui.title": "kvcoder.app.title",
+    "kvwebui.home": "kvcoder.chat",
+    "kvai.defaultModel": "anthropic/claude-sonnet-5-5"
+  }
+}