@kvman/testkit 0.1.0

package/dist/fake-openai.js

@@ -0,0 +1,115 @@
+import { createServer } from 'node:http';
+const noReply = { error: { message: 'The fake OpenAI server has no reply queued.', type: 'server_error' } };
+function chunkEvent(delta, finish) {
+    return { id: 'chatcmpl-fake', object: 'chat.completion.chunk', created: 0, model: 'fake', choices: [{ index: 0, delta, finish_reason: finish }] };
+}
+function usageEvent(usage) {
+    const cacheRead = usage.cacheRead ?? 0;
+    const cacheWrite = usage.cacheWrite ?? 0;
+    return {
+        id: 'chatcmpl-fake',
+        object: 'chat.completion.chunk',
+        created: 0,
+        model: 'fake',
+        choices: [],
+        usage: {
+            prompt_tokens: usage.input + cacheRead + cacheWrite,
+            completion_tokens: usage.output,
+            total_tokens: usage.input + cacheRead + cacheWrite + usage.output,
+            prompt_tokens_details: { cached_tokens: cacheRead, cache_write_tokens: cacheWrite },
+        },
+    };
+}
+function deltasOf(chunk, toolIndex) {
+    if ('text' in chunk)
+        return [{ content: chunk.text }];
+    if ('thinking' in chunk)
+        return [{ reasoning_content: chunk.thinking }];
+    const call = chunk.toolCall;
+    const pieces = 'arguments' in call ? [JSON.stringify(call.arguments)] : call.argumentPieces;
+    return pieces.map((piece, position) => ({
+        tool_calls: [{ index: toolIndex, ...(position === 0 ? { id: call.id, type: 'function' } : {}), function: { ...(position === 0 ? { name: call.name } : {}), arguments: piece } }],
+    }));
+}
+async function stream(response, request, reply) {
+    const send = (event) => {
+        response.write(`data: ${JSON.stringify(event)}\n\n`);
+    };
+    response.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-cache' });
+    send(chunkEvent({ role: 'assistant', content: '' }, null));
+    let toolIndex = 0;
+    for (const chunk of reply.chunks) {
+        if ('wait' in chunk) {
+            await chunk.wait;
+            if (request.state === 'aborted')
+                return;
+            continue;
+        }
+        for (const delta of deltasOf(chunk, toolIndex))
+            send(chunkEvent(delta, null));
+        if ('toolCall' in chunk)
+            toolIndex += 1;
+    }
+    send(chunkEvent({}, reply.finish ?? (toolIndex > 0 ? 'tool_calls' : 'stop')));
+    if (reply.usage !== undefined)
+        send(usageEvent(reply.usage));
+    response.end('data: [DONE]\n\n');
+}
+function readBody(message) {
+    return new Promise((resolve, reject) => {
+        let text = '';
+        message.setEncoding('utf8');
+        message.on('data', (piece) => (text += piece));
+        message.on('end', () => resolve(text));
+        message.on('error', reject);
+    });
+}
+async function answer(message, response, queued, seen) {
+    if (message.method !== 'POST' || message.url !== '/v1/chat/completions') {
+        response.writeHead(404, { 'content-type': 'application/json' }).end(JSON.stringify({ error: { message: 'Not found.' } }));
+        return;
+    }
+    const request = { authorization: message.headers.authorization, body: JSON.parse(await readBody(message)), state: 'answering' };
+    seen.push(request);
+    response.on('close', () => {
+        if (!response.writableFinished)
+            request.state = 'aborted';
+    });
+    const reply = queued.shift();
+    if (reply === undefined) {
+        response.writeHead(500, { 'content-type': 'application/json' }).end(JSON.stringify(noReply));
+    }
+    else if ('status' in reply) {
+        response.writeHead(reply.status, { 'content-type': 'application/json' }).end(JSON.stringify(reply.body));
+    }
+    else {
+        await stream(response, request, reply);
+    }
+    if (request.state === 'answering')
+        request.state = 'answered';
+}
+/** Starts a fake OpenAI-compatible streaming server on 127.0.0.1 for LLM tests. */
+export async function startFakeOpenAI() {
+    const queued = [];
+    const seen = [];
+    const server = createServer((message, response) => {
+        answer(message, response, queued, seen).catch((error) => {
+            response.destroy(error instanceof Error ? error : new Error(String(error)));
+        });
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const address = server.address();
+    const port = typeof address === 'object' && address !== null ? address.port : 0;
+    return {
+        baseUrl: `http://127.0.0.1:${String(port)}/v1`,
+        reply: (...replies) => {
+            queued.push(...replies);
+        },
+        requests: () => seen,
+        close: () => new Promise((resolve) => {
+            server.closeAllConnections();
+            server.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=fake-openai.js.map

package/dist/fake-openai.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { type LogLevel, type ProgressChunk } from '@kvman/kernel';
+import { type CommandInputOf, type InputOf, type Job, type Json, type OutputOf } from '@kvman/sdk';
+import { type TestClock } from './fake-clock.ts';
+export type { TestClock } from './fake-clock.ts';
+export type { ProgressChunk } from '@kvman/kernel';
+/** What a test kernel starts with (plan 10). */
+export type TestKernelOptions = {
+    /** Folders of the extensions to load, relative to the working folder; each loads as a `path:` extension. */
+    extensions: readonly string[];
+    /** The run's preset settings. */
+    settings?: Readonly<Record<string, Json>>;
+    /** Secrets to write before the extensions load: `{ "<extension package>": { "<name>": "<value>" } }`. */
+    secrets?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** The log level of the test kernel's `logs/kvman.log` (default `debug`). */
+    logLevel?: LogLevel;
+};
+/** How a test call runs: as the user (the default) or as an extension, in Home or another workspace. */
+export type TestCallOptions = {
+    /** The package name of the extension to call as. */
+    as?: string;
+    /** The workspace to run in (default Home). */
+    workspaceId?: string;
+    /** Receives the progress chunks of the call's root job, `{ source, data }`, until it ends or the kernel stops. */
+    onProgress?: (chunk: ProgressChunk) => void;
+};
+/** A real kernel in-process, with a temporary home, a fake clock, and no HTTP. */
+export type TestKernel = {
+    /** The temporary kvman home. */
+    home: string;
+    /** The temporary folder of the Home workspace. */
+    homeFolder: string;
+    /** The fake clock of the kernel's own timers: retries, schedules, retention, and ids. */
+    clock: TestClock;
+    /** Runs a command or query now and resolves to its output. */
+    exec<Name extends string>(name: Name, input: InputOf<Name>, options?: TestCallOptions): Promise<OutputOf<Name>>;
+    /** Queues a command and resolves to its job id. */
+    execAsync<Name extends string>(name: Name, input: CommandInputOf<Name>, options?: TestCallOptions): Promise<string>;
+    /** Resolves with the job once it has ended. */
+    waitForJob(jobId: string): Promise<Job>;
+    /** Receives a job's progress chunks from now on, as its HTTP stream does, until `stop` or the kernel stops. */
+    watch(jobId: string, onProgress: (chunk: ProgressChunk) => void): () => void;
+    /** Cancels a job. */
+    cancel(jobId: string): void;
+    /** Resolves when `kernel.restart` is called on the kernel that runs now; a test kernel doesn't restart by itself. */
+    restartRequested(): Promise<void>;
+    /** Stops the kernel as Ctrl+C does, moves the fake clock by `stoppedForMs` (default 0), then starts it again on the same home. */
+    restart(options?: {
+        stoppedForMs?: number;
+    }): Promise<void>;
+    /** Stops the kernel and removes its temporary folders. */
+    close(): Promise<void>;
+};
+/** Starts a test kernel: one worker unless `settings` set `kernel.workers`, and a temporary Home (ADR 0009, 10 and 11). */
+export declare function createTestKernel(options: TestKernelOptions): Promise<TestKernel>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8D,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9H,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAe,MAAM,YAAY,CAAC;AAChI,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4GAA4G;IAC5G,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1C,yGAAyG;IACzG,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,wGAAwG;AACxG,MAAM,MAAM,eAAe,GAAG;IAC5B,oDAAoD;IACpD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kHAAkH;IAClH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,KAAK,EAAE,SAAS,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChH,mDAAmD;IACnD,SAAS,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpH,+CAA+C;IAC/C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,+GAA+G;IAC/G,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC7E,qBAAqB;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qHAAqH;IACrH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,kIAAkI;IAClI,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAmBF,2HAA2H;AAC3H,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoFtF"}

package/dist/index.js

@@ -0,0 +1,111 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { homeWorkspaceId, openSecretsFile, startKernel } from '@kvman/kernel';
+import { z } from '@kvman/sdk';
+import { createFakeClock } from "./fake-clock.js";
+const manifestNameSchema = z.object({ name: z.string() });
+function packageName(folder) {
+    return manifestNameSchema.parse(JSON.parse(readFileSync(path.join(folder, 'package.json'), 'utf8'))).name;
+}
+function callerOf(options) {
+    return options?.as === undefined ? { kind: 'user' } : { kind: 'extension', name: options.as };
+}
+function writeSecrets(home, values) {
+    const secrets = openSecretsFile(home);
+    for (const [extension, named] of Object.entries(values ?? {})) {
+        for (const [name, value] of Object.entries(named))
+            secrets.set(extension, name, value);
+    }
+}
+/** Starts a test kernel: one worker unless `settings` set `kernel.workers`, and a temporary Home (ADR 0009, 10 and 11). */
+export async function createTestKernel(options) {
+    const root = mkdtempSync(path.join(tmpdir(), 'kvman-test-'));
+    const home = path.join(root, 'home');
+    const homeFolder = path.join(root, 'home-folder');
+    mkdirSync(home);
+    mkdirSync(homeFolder);
+    writeSecrets(home, options.secrets);
+    const folders = options.extensions.map((folder) => path.resolve(folder));
+    const extensions = Object.fromEntries(folders.map((folder) => [packageName(folder), `path:${folder}`]));
+    const preset = { name: 'test', extensions, settings: { 'kernel.workers': 1, ...options.settings } };
+    const clock = createFakeClock(Date.now());
+    const start = async () => {
+        const started = await startKernel({
+            home,
+            homeFolder,
+            preset,
+            presetFolder: process.cwd(),
+            bundled: new Map(),
+            mode: 'web',
+            logLevel: options.logLevel ?? 'debug',
+            terminalLog: false,
+            startFolder: homeFolder,
+            trust: () => Promise.resolve(true),
+            clock: clock.kernelClock,
+        });
+        clock.settleWith(() => started.settled());
+        return started;
+    };
+    let kernel;
+    try {
+        kernel = await start();
+    }
+    catch (error) {
+        rmSync(root, { recursive: true, force: true });
+        throw error;
+    }
+    const context = (callOptions) => ({ caller: callerOf(callOptions), workspaceId: callOptions?.workspaceId ?? homeWorkspaceId });
+    // An async job's watch lasts until the kernel stops, since its attempts may run at any later time.
+    const asyncWatches = [];
+    const stopAsyncWatches = () => {
+        for (const stop of asyncWatches.splice(0))
+            stop();
+    };
+    return {
+        home,
+        homeFolder,
+        clock: clock.testClock,
+        exec: async (name, input, callOptions) => {
+            const jobId = kernel.web.newJobId();
+            const onProgress = callOptions?.onProgress;
+            const stopWatching = onProgress === undefined ? undefined : kernel.watchProgress(jobId, onProgress);
+            try {
+                const output = await kernel.exec(name, input, { ...context(callOptions), jobId });
+                // The kernel checked the output against the registered schema; the declared type is the callee's promise.
+                return output;
+            }
+            finally {
+                stopWatching?.();
+            }
+        },
+        execAsync: async (name, input, callOptions) => {
+            const jobId = await kernel.execAsync(name, input, context(callOptions));
+            // Chunks come from a worker as messages, so none arrives before this continuation watches.
+            const onProgress = callOptions?.onProgress;
+            if (onProgress !== undefined)
+                asyncWatches.push(kernel.watchProgress(jobId, onProgress));
+            return jobId;
+        },
+        waitForJob: (jobId) => kernel.waitForJob(jobId),
+        watch: (jobId, onProgress) => {
+            const stop = kernel.watchProgress(jobId, onProgress);
+            asyncWatches.push(stop);
+            return stop;
+        },
+        cancel: (jobId) => kernel.cancel(jobId),
+        restartRequested: () => kernel.restartRequested,
+        restart: async (restartOptions) => {
+            stopAsyncWatches();
+            await kernel.close();
+            clock.moveWhileStopped(restartOptions?.stoppedForMs ?? 0);
+            kernel = await start();
+        },
+        close: async () => {
+            stopAsyncWatches();
+            await kernel.close();
+            rmSync(root, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/new/new-bin.d.ts

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

package/dist/new/new-bin.d.ts.map

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

package/dist/new/new-bin.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { namespaceSchema, packageNameSchema } from '@kvman/sdk';
+import { BinFailure, printFailure } from "../bin/bin-failure.js";
+import { newProject } from "./new-project.js";
+// The `kvman-new` bin (plan 09 §9.2, plan 10, ADR 0010, 2): scaffolds an extension project and runs `npm install`
+// in it, for any harness or none. With `--json` it prints the created project as one JSON line.
+const usage = 'Usage: kvman-new <folder> --name <name> --namespace <namespace> [--web] [--json]';
+const namespaceInput = namespaceSchema.refine((namespace) => namespace !== 'kernel', "kernel is the kernel's own namespace.");
+function parseOptions(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: {
+                name: { type: 'string' },
+                namespace: { type: 'string' },
+                web: { type: 'boolean', default: false },
+                json: { type: 'boolean', default: false },
+            },
+        });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new BinFailure('VALIDATION_FAILED', `${reason} ${usage}`);
+    }
+    const [folder, ...rest] = parsed.positionals;
+    if (folder === undefined || rest.length > 0)
+        throw new BinFailure('VALIDATION_FAILED', `A single <folder> argument is required. ${usage}`);
+    if (parsed.values.name === undefined)
+        throw new BinFailure('VALIDATION_FAILED', `--name is required. ${usage}`);
+    if (parsed.values.namespace === undefined)
+        throw new BinFailure('VALIDATION_FAILED', `--namespace is required. ${usage}`);
+    const name = packageNameSchema.safeParse(parsed.values.name);
+    if (!name.success)
+        throw new BinFailure('VALIDATION_FAILED', `Invalid --name ${JSON.stringify(parsed.values.name)}: use a lowercase npm package name, with an optional @scope/.`);
+    const namespace = namespaceInput.safeParse(parsed.values.namespace);
+    if (!namespace.success) {
+        const reason = parsed.values.namespace === 'kernel' ? "kernel is the kernel's own namespace." : 'use a lowercase kebab-case namespace.';
+        throw new BinFailure('VALIDATION_FAILED', `Invalid --namespace ${JSON.stringify(parsed.values.namespace)}: ${reason}`);
+    }
+    return { folder, name: name.data, namespace: namespace.data, web: parsed.values.web ?? false, json: parsed.values.json ?? false };
+}
+const json = process.argv.includes('--json');
+try {
+    const options = parseOptions(process.argv.slice(2));
+    const created = await newProject({ folder: options.folder, name: options.name, namespace: options.namespace, web: options.web });
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify({ folder: created.folder, name: created.name, namespace: created.namespace, web: created.web })}\n`);
+    }
+    else {
+        process.stdout.write([`Created ${created.name} (namespace ${created.namespace}) in ${created.folder}.`, 'Next steps:', `  cd ${options.folder}`, '  npm test', '  npm run check', '  kvman-preview'].join('\n') + '\n');
+    }
+}
+catch (error) {
+    printFailure(error, json);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=new-bin.js.map

package/dist/new/new-bin.js.map

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

package/dist/new/new-project.d.ts

@@ -0,0 +1,11 @@
+import { type ScaffoldInput } from './scaffold-files.ts';
+export type NewProject = {
+    folder: string;
+    name: string;
+    namespace: string;
+    web: boolean;
+};
+export declare function newProject(input: ScaffoldInput & {
+    folder: string;
+}): Promise<NewProject>;
+//# sourceMappingURL=new-project.d.ts.map

package/dist/new/new-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-project.d.ts","sourceRoot":"","sources":["../../src/new/new-project.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMxE,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAO3F,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAqB/F"}

package/dist/new/new-project.js

@@ -0,0 +1,36 @@
+import { mkdirSync, readdirSync, statSync, writeFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { BinFailure } from "../bin/bin-failure.js";
+import { lastLines, runProgram } from "../bin/run-program.js";
+import { scaffoldFiles } from "./scaffold-files.js";
+function assertEmpty(absolute, given) {
+    if (!existsSync(absolute))
+        return;
+    if (!statSync(absolute).isDirectory() || readdirSync(absolute).length > 0)
+        throw new BinFailure('FOLDER_NOT_EMPTY', `${given} isn't empty; choose a new or empty folder.`, { folder: given });
+}
+export async function newProject(input) {
+    const absolute = path.resolve(input.folder);
+    assertEmpty(absolute, input.folder);
+    for (const [file, content] of Object.entries(scaffoldFiles(input))) {
+        mkdirSync(path.dirname(path.join(absolute, file)), { recursive: true });
+        writeFileSync(path.join(absolute, file), content);
+    }
+    let install;
+    try {
+        install = await runProgram('npm', ['install'], absolute);
+    }
+    catch (error) {
+        if (error instanceof BinFailure)
+            throw new BinFailure('NPM_FAILED', error.message, { folder: absolute });
+        throw error;
+    }
+    if (install.exitCode !== 0) {
+        throw new BinFailure('NPM_FAILED', `npm install failed in ${input.folder} (exit code ${String(install.exitCode)}):\n${lastLines(install.output)}`, {
+            folder: absolute,
+            exitCode: install.exitCode,
+        });
+    }
+    return { folder: absolute, name: input.name, namespace: input.namespace, web: input.web };
+}
+//# sourceMappingURL=new-project.js.map

package/dist/new/new-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-project.js","sourceRoot":"","sources":["../../src/new/new-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAQxE,SAAS,WAAW,CAAC,QAAgB,EAAE,KAAa;IAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAClC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,6CAA6C,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAChM,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAyC;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,UAAU;YAAE,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzG,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,yBAAyB,KAAK,CAAC,MAAM,eAAe,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;YACjJ,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;AAC5F,CAAC"}

package/dist/new/scaffold-files.d.ts

@@ -0,0 +1,7 @@
+export type ScaffoldInput = {
+    name: string;
+    namespace: string;
+    web: boolean;
+};
+export declare function scaffoldFiles(input: ScaffoldInput): Record<string, string>;
+//# sourceMappingURL=scaffold-files.d.ts.map

package/dist/new/scaffold-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-files.d.ts","sourceRoot":"","sources":["../../src/new/scaffold-files.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAiF9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwB1E"}

package/dist/new/scaffold-files.js

@@ -0,0 +1,100 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { scaffoldVersions } from "./scaffold-versions.js";
+const templates = fileURLToPath(new URL('../../templates/', import.meta.url));
+const guides = fileURLToPath(new URL('../../docs/', import.meta.url));
+function template(file, input, extra = {}) {
+    let text = readFileSync(`${templates}${file}.template`, 'utf8').replaceAll('__NAMESPACE__', input.namespace).replaceAll('__NAME__', input.name);
+    for (const [placeholder, value] of Object.entries(extra))
+        text = text.replaceAll(placeholder, value);
+    return text;
+}
+function guide(file) {
+    return readFileSync(`${guides}${file}`, 'utf8');
+}
+function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function packageJson(input) {
+    const web = input.web
+        ? { scripts: { 'web:build': 'node web-build.ts', 'web:watch': 'node web-build.ts --watch' }, devDependencies: { '@vitejs/plugin-vue': scaffoldVersions.pluginVue, vite: scaffoldVersions.vite, vue: scaffoldVersions.vue } }
+        : { scripts: {}, devDependencies: {} };
+    return {
+        name: input.name,
+        version: '0.1.0',
+        description: `The ${input.namespace} kvman extension.`,
+        type: 'module',
+        main: 'dist/index.js',
+        files: ['dist', 'locales', 'extension-docs'],
+        scripts: { build: input.web ? 'tsc -p tsconfig.build.json && npm run web:build' : 'tsc -p tsconfig.build.json', check: 'kvman-check', test: 'node --test "test/**/*.test.ts"', ...web.scripts },
+        peerDependencies: { '@kvman/sdk': '^0.1.0' },
+        devDependencies: {
+            '@kvman/sdk': scaffoldVersions.sdk,
+            '@kvman/testkit': scaffoldVersions.testkit,
+            '@types/node': scaffoldVersions.typesNode,
+            typescript: scaffoldVersions.typescript,
+            ...web.devDependencies,
+        },
+        kvman: { namespace: input.namespace, source: 'src/index.ts', dependencies: {}, ...(input.web ? { web: 'dist/web' } : {}) },
+    };
+}
+const compilerOptions = {
+    target: 'es2024',
+    lib: ['es2024'],
+    module: 'nodenext',
+    moduleResolution: 'nodenext',
+    types: ['node'],
+    strict: true,
+    verbatimModuleSyntax: true,
+    erasableSyntaxOnly: true,
+    allowImportingTsExtensions: true,
+    rewriteRelativeImportExtensions: true,
+    skipLibCheck: true,
+    noEmit: true,
+};
+function catalogs(input) {
+    const key = (suffix) => `${input.namespace}.${suffix}`;
+    const en = { [key('title')]: input.namespace, [key('pages.hello')]: 'Hello' };
+    const ar = { [key('title')]: input.namespace, [key('pages.hello')]: 'مرحبا' };
+    if (input.web) {
+        Object.assign(en, { [key('hello.text')]: 'Hello from a Vue component!', [key('hello.count')]: 'Count: {count}' });
+        Object.assign(ar, { [key('hello.text')]: 'مرحبا من مكوّن Vue!', [key('hello.count')]: 'العدد: {count}' });
+    }
+    return { en, ar };
+}
+function pageView(input) {
+    const greeting = `{ type: 'markdown', query: '${input.namespace}.greeting.get', input: {}, field: 'text' }`;
+    if (!input.web)
+        return greeting;
+    return `{ type: 'stack', direction: 'vertical', gap: 'md', children: [${greeting}, { type: 'custom', component: '${input.namespace}.hello', props: {} }] }`;
+}
+const webReadme = `- \`web/components/*.vue\` are custom components: \`npm run web:build\` builds each into \`dist/web/components/<name>.js\` and \`.css\`, and \`npm run web:watch\` rebuilds them on change; a page refresh shows them.
+`;
+const webAgents = `- \`web/components/*.vue\` are custom components: \`npm run web:build\` builds each into \`dist/web\`, and a page refresh shows them.
+`;
+export function scaffoldFiles(input) {
+    const { en, ar } = catalogs(input);
+    const files = {
+        'package.json': json(packageJson(input)),
+        'tsconfig.json': json({ compilerOptions, include: ['src', 'test', '*.ts'] }),
+        'tsconfig.build.json': json({ extends: './tsconfig.json', compilerOptions: { noEmit: false, rootDir: 'src', outDir: 'dist', declaration: true }, include: ['src'] }),
+        'src/index.ts': template('src/index.ts', input, { __PAGE_VIEW__: pageView(input) }),
+        'src/docs.ts': template('src/docs.ts', input),
+        'test/extension.test.ts': template('test/extension.test.ts', input),
+        'locales/en.json': json(en),
+        'locales/ar.json': json(ar),
+        'README.md': template('README.md', input, { __WEB_README__: input.web ? webReadme : '' }),
+        'AGENTS.md': template('AGENTS.md', input, { __WEB_AGENTS__: input.web ? webAgents : '' }),
+        'CLAUDE.md': '@AGENTS.md\n',
+        'docs/sdk.md': guide('sdk.md'),
+        'docs/i18n.md': guide('i18n.md'),
+        'docs/presets.md': guide('presets.md'),
+        'extension-docs/usage.md': template('extension-docs/usage.md', input),
+    };
+    if (input.web) {
+        files['web/components/Hello.vue'] = template('web/components/Hello.vue', input);
+        files['web-build.ts'] = template('web-build.ts', input);
+    }
+    return files;
+}
+//# sourceMappingURL=scaffold-files.js.map

package/dist/new/scaffold-files.js.map

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

package/dist/new/scaffold-versions.d.ts

@@ -0,0 +1,10 @@
+export declare const scaffoldVersions: {
+    readonly sdk: "0.1.0";
+    readonly testkit: "0.1.0";
+    readonly typescript: "6.0.3";
+    readonly typesNode: "24.19.0";
+    readonly vite: "8.3.1";
+    readonly pluginVue: "6.0.9";
+    readonly vue: "3.5.43";
+};
+//# sourceMappingURL=scaffold-versions.d.ts.map

package/dist/new/scaffold-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-versions.d.ts","sourceRoot":"","sources":["../../src/new/scaffold-versions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC"}

package/dist/new/scaffold-versions.js

@@ -0,0 +1,12 @@
+// The versions a scaffold pins (plan 09 §9.2, ADR 0009, 126–127): those the running kvman bundles. A test checks them
+// against the monorepo, so a version bump there fails until this follows.
+export const scaffoldVersions = {
+    sdk: '0.1.0',
+    testkit: '0.1.0',
+    typescript: '6.0.3',
+    typesNode: '24.19.0',
+    vite: '8.3.1',
+    pluginVue: '6.0.9',
+    vue: '3.5.43',
+};
+//# sourceMappingURL=scaffold-versions.js.map

package/dist/new/scaffold-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-versions.js","sourceRoot":"","sources":["../../src/new/scaffold-versions.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,OAAO;IACZ,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,OAAO;IACnB,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,OAAO;IAClB,GAAG,EAAE,QAAQ;CACL,CAAC"}

package/dist/preset/preset-bin.d.ts

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

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

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