@kvman/kvbuilder 0.2.0

package/dist/docs/register-docs.js

@@ -0,0 +1,25 @@
+import { z } from '@kvman/sdk';
+import { getGuide, guideListSchema, guideSchema, listGuides } from "./guides.js";
+import { registerOwnDocs } from "./own-docs.js";
+// What the `docs` connector calls (plan 09 §9.1), and kvbuilder's own docs pair.
+export function registerDocs(ctx) {
+    ctx.registerQuery('kvbuilder.guides.list', {
+        description: 'Lists the guides of kvman and the documentation pages of every installed extension that serves docs.',
+        public: true,
+        input: z.object({}),
+        output: guideListSchema,
+        handle: () => listGuides(ctx),
+    });
+    ctx.registerQuery('kvbuilder.guides.get', {
+        description: "Gives one guide of kvman, or one page of an installed extension's docs, as Markdown.",
+        public: true,
+        input: z.object({
+            extension: z.string().min(1).optional().describe('The extension package name, such as @kvman/kvwebui; leave it out (or kvman) for a built-in guide.'),
+            topic: z.string().describe('The page topic, such as sdk or views.'),
+        }),
+        output: guideSchema,
+        handle: (input) => getGuide(ctx, input),
+    });
+    registerOwnDocs(ctx);
+}
+//# sourceMappingURL=register-docs.js.map

package/dist/docs/register-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-docs.js","sourceRoot":"","sources":["../../src/docs/register-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,iFAAiF;AAEjF,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,GAAG,CAAC,aAAa,CAAC,uBAAuB,EAAE;QACzC,WAAW,EAAE,sGAAsG;QACnH,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;KAC9B,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,sBAAsB,EAAE;QACxC,WAAW,EAAE,sFAAsF;QACnG,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;YACrJ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACpE,CAAC;QACF,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;KACxC,CAAC,CAAC;IACH,eAAe,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/ext/ext-check.d.ts

@@ -0,0 +1,8 @@
+import { type Finding } from './findings.ts';
+export declare function checkProject(folder: string, signal: AbortSignal): Promise<Finding[]>;
+export declare function testProject(folder: string, signal: AbortSignal): Promise<{
+    passed: boolean;
+    exitCode: number;
+    output: string;
+}>;
+//# sourceMappingURL=ext-check.d.ts.map

package/dist/ext/ext-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-check.d.ts","sourceRoot":"","sources":["../../src/ext/ext-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAe5F,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAQ1F;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAGrI"}

package/dist/ext/ext-check.js

@@ -0,0 +1,26 @@
+import { lastLines, runProgram } from "../run-program.js";
+import { checkFindings, outputTail, typeScriptFindings } from "./findings.js";
+// `ext check` and `ext test` (plan 09 §9.1, ADR 0009, 117, 126): the project's own toolchain, run in its folder.
+function checkFailed(run) {
+    return {
+        message: `npm run check failed with exit code ${String(run.exitCode)}:\n${lastLines(run.output)}`,
+        hint: 'Run npm install in the project, and keep its check script as kvman-check.',
+    };
+}
+function typeScriptFailed(run) {
+    return { message: `npx tsc failed with exit code ${String(run.exitCode)}:\n${lastLines(run.output)}`, hint: 'Run npm install in the project, so its own TypeScript is there.' };
+}
+export async function checkProject(folder, signal) {
+    const typeScript = await runProgram('npx', ['tsc', '--noEmit', '--pretty', 'false'], folder, signal);
+    const typeFindings = typeScriptFindings(typeScript.stdout);
+    const check = await runProgram('npm', ['run', 'check', '--', '--json'], folder, signal);
+    return [
+        ...(typeScript.exitCode !== 0 && typeFindings.length === 0 ? [typeScriptFailed(typeScript)] : typeFindings),
+        ...(checkFindings(check.stdout) ?? [checkFailed(check)]),
+    ];
+}
+export async function testProject(folder, signal) {
+    const run = await runProgram('npm', ['test'], folder, signal);
+    return { passed: run.exitCode === 0, exitCode: run.exitCode, output: outputTail(run.output) };
+}
+//# sourceMappingURL=ext-check.js.map

package/dist/ext/ext-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-check.js","sourceRoot":"","sources":["../../src/ext/ext-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAgB,MAAM,eAAe,CAAC;AAE5F,iHAAiH;AAEjH,SAAS,WAAW,CAAC,GAAe;IAClC,OAAO;QACL,OAAO,EAAE,uCAAuC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QACjG,IAAI,EAAE,2EAA2E;KAClF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAe;IACvC,OAAO,EAAE,OAAO,EAAE,iCAAiC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,iEAAiE,EAAE,CAAC;AAClL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAmB;IACpE,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrG,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxF,OAAO;QACL,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAC3G,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAmB;IACnE,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;AAChG,CAAC"}

package/dist/ext/ext-list.d.ts

@@ -0,0 +1,8 @@
+export type ProjectRow = {
+    folder: string;
+    name: string;
+    namespace: string;
+    version: string;
+};
+export declare function listProjects(workspaceFolder: string): ProjectRow[];
+//# sourceMappingURL=ext-list.d.ts.map

package/dist/ext/ext-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-list.d.ts","sourceRoot":"","sources":["../../src/ext/ext-list.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAa9F,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,EAAE,CAIlE"}

package/dist/ext/ext-list.js

@@ -0,0 +1,20 @@
+import { readdirSync } from 'node:fs';
+import path from 'node:path';
+import { readProjectManifest, workspaceRelative } from "../folders.js";
+function walk(workspaceFolder, folder, rows) {
+    const manifest = readProjectManifest(folder);
+    if (manifest !== undefined) {
+        rows.push({ folder: workspaceRelative(workspaceFolder, folder), name: manifest.name, namespace: manifest.namespace, version: manifest.version });
+        return;
+    }
+    for (const entry of readdirSync(folder, { withFileTypes: true })) {
+        if (entry.isDirectory() && entry.name !== 'node_modules' && !entry.name.startsWith('.'))
+            walk(workspaceFolder, path.join(folder, entry.name), rows);
+    }
+}
+export function listProjects(workspaceFolder) {
+    const rows = [];
+    walk(workspaceFolder, workspaceFolder, rows);
+    return rows.sort((a, b) => a.folder.localeCompare(b.folder));
+}
+//# sourceMappingURL=ext-list.js.map

package/dist/ext/ext-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-list.js","sourceRoot":"","sources":["../../src/ext/ext-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOvE,SAAS,IAAI,CAAC,eAAuB,EAAE,MAAc,EAAE,IAAkB;IACvE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACjJ,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACtJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,eAAuB;IAClD,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,IAAI,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type Ctx } from '@kvman/sdk';
+export type NewProject = {
+    folder: string;
+    name: string;
+    namespace: string;
+    web: boolean;
+};
+export type NewProjectInput = {
+    name: string;
+    namespace: string;
+    folder: string;
+    web: boolean;
+};
+export declare function newProject(ctx: Ctx, workspaceFolder: string, input: NewProjectInput, signal: AbortSignal): Promise<NewProject>;
+//# sourceMappingURL=ext-new.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ext-new.d.ts","sourceRoot":"","sources":["../../src/ext/ext-new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAOzC,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;AAE3F,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAIhG,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAKpI"}

package/dist/ext/ext-new.js

@@ -0,0 +1,11 @@
+import { z } from '@kvman/sdk';
+import { insideWorkspace, workspaceRelative } from "../folders.js";
+import { binResult, runBin } from "../run-bin.js";
+const newOutputSchema = z.object({ folder: z.string(), name: z.string(), namespace: z.string(), web: z.boolean() });
+export async function newProject(ctx, workspaceFolder, input, signal) {
+    insideWorkspace(workspaceFolder, input.folder, 'folder');
+    const run = await runBin('kvman-new', [input.folder, '--name', input.name, '--namespace', input.namespace, ...(input.web ? ['--web'] : [])], workspaceFolder, signal);
+    const created = binResult(ctx.log, 'kvman-new', run, newOutputSchema);
+    return { folder: workspaceRelative(workspaceFolder, created.folder), name: created.name, namespace: created.namespace, web: created.web };
+}
+//# sourceMappingURL=ext-new.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ext-new.js","sourceRoot":"","sources":["../../src/ext/ext-new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AASlD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAEpH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,eAAuB,EAAE,KAAsB,EAAE,MAAmB;IAC7G,eAAe,CAAC,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IACtK,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC;IACtE,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;AAC5I,CAAC"}

package/dist/ext/findings.d.ts

@@ -0,0 +1,12 @@
+export type Finding = {
+    file?: string;
+    message: string;
+    hint: string;
+};
+export declare function typeScriptFindings(output: string): Finding[];
+/** The findings `kvman-check --json` printed on its last line, or `undefined` when that line isn't its array. */
+export declare function checkFindings(stdout: string): Finding[] | undefined;
+export declare const outputTailLimit: number;
+/** The last 30 KB of an output, marked when the start was cut. */
+export declare function outputTail(output: string): string;
+//# sourceMappingURL=findings.d.ts.map

package/dist/ext/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../src/ext/findings.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAQvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAW5D;AAED,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,SAAS,CAWnE;AAED,eAAO,MAAM,eAAe,QAAY,CAAC;AAEzC,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/ext/findings.js

@@ -0,0 +1,44 @@
+import { z } from '@kvman/sdk';
+const findingsSchema = z.array(z.strictObject({ file: z.string().optional(), message: z.string(), hint: z.string() }));
+const located = /^(.+)\((\d+),(\d+)\): (?:error|warning) (TS\d+): (.*)$/;
+const global = /^(?:error|warning) (TS\d+): (.*)$/;
+const typeHint = 'Fix the type error at that line, then run ext check again.';
+export function typeScriptFindings(output) {
+    const findings = [];
+    for (const line of output.split(/\r?\n/)) {
+        const at = located.exec(line);
+        const anywhere = at === null ? global.exec(line) : null;
+        const last = findings.at(-1);
+        if (at !== null)
+            findings.push({ file: `${(at[1] ?? '').replaceAll('\\', '/')}:${at[2] ?? ''}:${at[3] ?? ''}`, message: `${at[4] ?? ''}: ${at[5] ?? ''}`, hint: typeHint });
+        else if (anywhere !== null)
+            findings.push({ message: `${anywhere[1] ?? ''}: ${anywhere[2] ?? ''}`, hint: typeHint });
+        else if (last !== undefined && /^\s+\S/.test(line))
+            last.message += `\n${line.trim()}`;
+    }
+    return findings;
+}
+/** The findings `kvman-check --json` printed on its last line, or `undefined` when that line isn't its array. */
+export function checkFindings(stdout) {
+    const lastLine = stdout.trimEnd().split('\n').at(-1) ?? '';
+    let parsed;
+    try {
+        parsed = JSON.parse(lastLine);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    const findings = findingsSchema.safeParse(parsed);
+    return findings.success ? findings.data.map(({ file, message, hint }) => (file === undefined ? { message, hint } : { file, message, hint })) : undefined;
+}
+export const outputTailLimit = 30 * 1024;
+/** The last 30 KB of an output, marked when the start was cut. */
+export function outputTail(output) {
+    const bytes = Buffer.from(output, 'utf8');
+    if (bytes.length <= outputTailLimit)
+        return output;
+    return `[… the first ${String(bytes.length - outputTailLimit)} bytes were cut …]\n${bytes.subarray(bytes.length - outputTailLimit).toString('utf8')}`;
+}
+//# sourceMappingURL=findings.js.map

package/dist/ext/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/ext/findings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAQ/B,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAEvH,MAAM,OAAO,GAAG,wDAAwD,CAAC;AACzE,MAAM,MAAM,GAAG,mCAAmC,CAAC;AACnD,MAAM,QAAQ,GAAG,4DAA4D,CAAC;AAE9E,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;aACvK,IAAI,QAAQ,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;aAChH,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,SAAS,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3J,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzC,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,gBAAgB,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,uBAAuB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AACxJ,CAAC"}

package/dist/ext/register-ext.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerExt(ctx: Ctx): void;
+//# sourceMappingURL=register-ext.d.ts.map

package/dist/ext/register-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-ext.d.ts","sourceRoot":"","sources":["../../src/ext/register-ext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAmB7E,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAgC1C"}

package/dist/ext/register-ext.js

@@ -0,0 +1,49 @@
+import { namespaceSchema, packageNameSchema, z } from '@kvman/sdk';
+import { projectAt } from "../folders.js";
+import { jobOptions } from "../job-options.js";
+import { checkProject, testProject } from "./ext-check.js";
+import { listProjects } from "./ext-list.js";
+import { newProject } from "./ext-new.js";
+// The `ext` connector's commands (plan 09 §9.1): scaffold, list, check, and test extension projects in the workspace.
+const folderInput = z.object({ folder: z.string().min(1).describe('The project folder, relative to the workspace folder.') });
+const findingSchema = z.object({ file: z.string().optional(), message: z.string(), hint: z.string() });
+const newInput = z.object({
+    name: packageNameSchema.describe('The npm package name, such as notes or @me/notes.'),
+    namespace: namespaceSchema.refine((namespace) => namespace !== 'kernel', 'kernel is the kernel\'s own namespace.').describe('The namespace every name starts with, such as notes.'),
+    folder: z.string().min(1).describe('The new or empty folder to write it in, relative to the workspace folder.'),
+    web: z.boolean().optional().describe('Whether to add a Vue custom component and its build.'),
+});
+export function registerExt(ctx) {
+    ctx.registerCommand('kvbuilder.ext.new', {
+        description: 'Scaffolds an extension project and runs npm install in it.',
+        public: true,
+        ...jobOptions['kvbuilder.ext.new'],
+        input: newInput,
+        output: z.object({ folder: z.string(), name: z.string(), namespace: z.string(), web: z.boolean() }),
+        handle: (input) => newProject(ctx, ctx.job.workspace.path, { name: input.name, namespace: input.namespace, folder: input.folder, web: input.web ?? false }, ctx.job.signal),
+    });
+    ctx.registerQuery('kvbuilder.ext.list', {
+        description: 'Lists the extension projects in the workspace folder.',
+        public: true,
+        input: z.object({}),
+        output: z.array(z.object({ folder: z.string(), name: z.string(), namespace: z.string(), version: z.string() })),
+        handle: () => listProjects(ctx.job.workspace.path),
+    });
+    ctx.registerCommand('kvbuilder.ext.check', {
+        description: 'Type-checks a project and runs its kvman check.',
+        public: true,
+        ...jobOptions['kvbuilder.ext.check'],
+        input: folderInput,
+        output: z.array(findingSchema),
+        handle: (input) => checkProject(projectAt(ctx.job.workspace.path, input.folder).folder, ctx.job.signal),
+    });
+    ctx.registerCommand('kvbuilder.ext.test', {
+        description: "Runs a project's tests.",
+        public: true,
+        ...jobOptions['kvbuilder.ext.test'],
+        input: folderInput,
+        output: z.object({ passed: z.boolean(), exitCode: z.number(), output: z.string() }),
+        handle: (input) => testProject(projectAt(ctx.job.workspace.path, input.folder).folder, ctx.job.signal),
+    });
+}
+//# sourceMappingURL=register-ext.js.map

package/dist/ext/register-ext.js.map

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

package/dist/folders.d.ts

@@ -0,0 +1,18 @@
+export type ProjectManifest = {
+    name: string;
+    version: string;
+    namespace: string;
+    scripts: Record<string, string>;
+};
+/** The absolute path of `relative` inside the workspace folder. */
+export declare function insideWorkspace(workspaceFolder: string, relative: string, what: string): string;
+/** A path as kvbuilder reports it: relative to the workspace folder, with `/`, and `.` for the folder itself. */
+export declare function workspaceRelative(workspaceFolder: string, absolute: string): string;
+/** The project manifest in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export declare function readProjectManifest(folder: string): ProjectManifest | undefined;
+/** The project in `folder`, which must be inside the workspace folder; `kvbuilder/NOT_A_PROJECT` otherwise. */
+export declare function projectAt(workspaceFolder: string, folder: string): {
+    folder: string;
+    manifest: ProjectManifest;
+};
+//# sourceMappingURL=folders.d.ts.map

package/dist/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../src/folders.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAWpH,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/F;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAa/E;AAED,+GAA+G;AAC/G,wBAAgB,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAKhH"}

package/dist/folders.js

@@ -0,0 +1,53 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { invalid, kvbuilderProblem } from "./problems.js";
+const manifestSchema = z
+    .object({
+    name: z.string(),
+    version: z.string(),
+    scripts: z.record(z.string(), z.string()).optional(),
+    kvman: z.object({ namespace: z.string() }).loose(),
+})
+    .loose();
+/** The absolute path of `relative` inside the workspace folder. */
+export function insideWorkspace(workspaceFolder, relative, what) {
+    const resolved = path.resolve(workspaceFolder, relative);
+    const fromWorkspace = path.relative(workspaceFolder, resolved);
+    if (fromWorkspace.startsWith('..') || path.isAbsolute(fromWorkspace)) {
+        throw invalid(`The ${what} ${relative} is outside the workspace folder ${workspaceFolder}.`, { [what]: relative });
+    }
+    return resolved;
+}
+/** A path as kvbuilder reports it: relative to the workspace folder, with `/`, and `.` for the folder itself. */
+export function workspaceRelative(workspaceFolder, absolute) {
+    return path.relative(workspaceFolder, absolute).split(path.sep).join('/') || '.';
+}
+/** The project manifest in `folder`, or `undefined` when it has no package.json with a `kvman` field. */
+export function readProjectManifest(folder) {
+    const file = path.join(folder, 'package.json');
+    if (!existsSync(file))
+        return undefined;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    const parsed = manifestSchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    return { name: parsed.data.name, version: parsed.data.version, namespace: parsed.data.kvman.namespace, scripts: parsed.data.scripts ?? {} };
+}
+/** The project in `folder`, which must be inside the workspace folder; `kvbuilder/NOT_A_PROJECT` otherwise. */
+export function projectAt(workspaceFolder, folder) {
+    const absolute = insideWorkspace(workspaceFolder, folder, 'folder');
+    const manifest = readProjectManifest(absolute);
+    if (manifest === undefined)
+        throw kvbuilderProblem('NOT_A_PROJECT', `${folder} has no package.json with a kvman field.`, { folder });
+    return { folder: absolute, manifest };
+}
+//# sourceMappingURL=folders.js.map

package/dist/folders.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Ctx } from '@kvman/sdk';
+export type {} from './api.ts';
+declare const _default: (ctx: Ctx) => void;
+export default _default;
+//# 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":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAWtC,YAAY,EAAE,MAAM,UAAU,CAAC;yBAKf,KAAK,GAAG,KAAG,IAAI;AAA/B,wBAUE"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { registerApp } from "./app/register-app.js";
+import { registerAppReads } from "./app/register-app-reads.js";
+import { registerBuild } from "./build/register-build.js";
+import { registerDocs } from "./docs/register-docs.js";
+import { registerExt } from "./ext/register-ext.js";
+import { registerPreset } from "./preset/register-preset.js";
+import { registerPreview } from "./preview/register-preview.js";
+import { registerAppQuery } from "./query/register-app-query.js";
+import { registerWithKvcoder } from "./register-with-kvcoder.js";
+// kvbuilder (plan 09): the harness for developing kvman extensions and presets, and for seeing and changing the app
+// itself. It has no loop of its own; it extends kvcoder with the kvman, ext, preset, preview, and docs connectors and
+// its guide, which a chat has once the person runs `/build-kvman` in it (ADR 0027).
+export default (ctx) => {
+    registerApp(ctx);
+    registerBuild(ctx);
+    registerAppReads(ctx);
+    registerAppQuery(ctx);
+    registerExt(ctx);
+    registerPreset(ctx);
+    registerPreview(ctx);
+    registerDocs(ctx);
+    registerWithKvcoder(ctx);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE,oHAAoH;AACpH,sHAAsH;AACtH,oFAAoF;AACpF,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/job-options.d.ts

@@ -0,0 +1,33 @@
+export declare const jobOptions: {
+    readonly 'kvbuilder.ext.new': {
+        readonly retries: 0;
+        readonly timeoutMs: 600000;
+    };
+    readonly 'kvbuilder.ext.check': {
+        readonly retries: 0;
+        readonly timeoutMs: 300000;
+    };
+    readonly 'kvbuilder.ext.test': {
+        readonly retries: 0;
+        readonly timeoutMs: 600000;
+    };
+    readonly 'kvbuilder.preview.start': {
+        readonly retries: 0;
+        readonly timeoutMs: 300000;
+    };
+    readonly 'kvbuilder.preview.stop': {
+        readonly retries: 0;
+    };
+    readonly 'kvbuilder.preview.command.run': {
+        readonly retries: 0;
+        readonly timeoutMs: 120000;
+    };
+    readonly 'kvbuilder.preset.new': {
+        readonly retries: 0;
+    };
+    readonly 'kvbuilder.preset.check': {
+        readonly retries: 0;
+        readonly timeoutMs: 300000;
+    };
+};
+//# sourceMappingURL=job-options.d.ts.map

package/dist/job-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-options.d.ts","sourceRoot":"","sources":["../src/job-options.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASb,CAAC"}

package/dist/job-options.js

@@ -0,0 +1,13 @@
+// Job options of kvbuilder's commands (ADR 0009, 126): every command has `retries: 0`, since each runs a program that a
+// retry would only run again; the long ones have their own timeouts.
+export const jobOptions = {
+    'kvbuilder.ext.new': { retries: 0, timeoutMs: 600_000 },
+    'kvbuilder.ext.check': { retries: 0, timeoutMs: 300_000 },
+    'kvbuilder.ext.test': { retries: 0, timeoutMs: 600_000 },
+    'kvbuilder.preview.start': { retries: 0, timeoutMs: 300_000 },
+    'kvbuilder.preview.stop': { retries: 0 },
+    'kvbuilder.preview.command.run': { retries: 0, timeoutMs: 120_000 },
+    'kvbuilder.preset.new': { retries: 0 },
+    'kvbuilder.preset.check': { retries: 0, timeoutMs: 300_000 },
+};
+//# sourceMappingURL=job-options.js.map

package/dist/job-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-options.js","sourceRoot":"","sources":["../src/job-options.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,qEAAqE;AAErE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mBAAmB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACvD,qBAAqB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACzD,oBAAoB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACxD,yBAAyB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IAC7D,wBAAwB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IACxC,+BAA+B,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;IACnE,sBAAsB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IACtC,wBAAwB,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;CACpD,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerPreset(ctx: Ctx): void;
+//# sourceMappingURL=register-preset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-preset.d.ts","sourceRoot":"","sources":["../../src/preset/register-preset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAyCzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAiB7C"}

package/dist/preset/register-preset.js

@@ -0,0 +1,55 @@
+import { z } from '@kvman/sdk';
+import { insideWorkspace, workspaceRelative } from "../folders.js";
+import { jobOptions } from "../job-options.js";
+import { binResult, lastOutputLine, runBin } from "../run-bin.js";
+// The `preset` connector's commands (plan 09 §9.1): `kvman-preset new` writes a preset skeleton, and
+// `kvman-preset check` validates a preset's references. Both take the file as given, relative to the workspace
+// folder, since the bin runs with the workspace folder as its working folder.
+const fileField = z.string().min(1).describe('The preset file, relative to the workspace folder.');
+const newOutputSchema = z.object({ file: z.string() });
+const checkOutputSchema = z.array(z.object({ file: z.string(), message: z.string(), hint: z.string() }));
+async function newPreset(ctx, workspaceFolder, name, file) {
+    insideWorkspace(workspaceFolder, file, 'file');
+    const run = await runBin('kvman-preset', ['new', file, '--name', name], workspaceFolder, ctx.job.signal);
+    const created = binResult(ctx.log, 'kvman-preset', run, newOutputSchema);
+    return { file: workspaceRelative(workspaceFolder, created.file) };
+}
+async function checkPreset(ctx, workspaceFolder, file) {
+    insideWorkspace(workspaceFolder, file, 'file');
+    const run = await runBin('kvman-preset', ['check', file], workspaceFolder, ctx.job.signal);
+    const line = lastOutputLine(run.stdout);
+    if (line !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            parsed = undefined;
+        }
+        if (parsed !== undefined) {
+            const findings = checkOutputSchema.safeParse(parsed);
+            if (findings.success)
+                return findings.data;
+        }
+    }
+    return binResult(ctx.log, 'kvman-preset', run, checkOutputSchema);
+}
+export function registerPreset(ctx) {
+    ctx.registerCommand('kvbuilder.preset.new', {
+        description: 'Writes a preset that runs as-is, for adding extensions and settings to.',
+        public: true,
+        ...jobOptions['kvbuilder.preset.new'],
+        input: z.object({ name: z.string().min(1).describe('The preset name, as kernel.health.get reports it.'), file: fileField }),
+        output: z.object({ file: z.string() }),
+        handle: (input) => newPreset(ctx, ctx.job.workspace.path, input.name, input.file),
+    });
+    ctx.registerCommand('kvbuilder.preset.check', {
+        description: "Checks a preset's schema and its extensions, settings, and home page.",
+        public: true,
+        ...jobOptions['kvbuilder.preset.check'],
+        input: z.object({ file: fileField }),
+        output: z.array(z.object({ file: z.string(), message: z.string(), hint: z.string() })),
+        handle: (input) => checkPreset(ctx, ctx.job.workspace.path, input.file),
+    });
+}
+//# sourceMappingURL=register-preset.js.map

package/dist/preset/register-preset.js.map

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

package/dist/preview/preview-call.d.ts

@@ -0,0 +1,20 @@
+import { z, type Ctx } from '@kvman/sdk';
+export type PreviewRoute = 'queries' | 'commands';
+/** The preview's envelope without its job id: the output of a call, or its Problem. */
+export declare const previewAnswerSchema: z.ZodUnion<readonly [z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    output: z.ZodJSONSchema;
+}, z.core.$strip>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    problem: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        params: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+export type PreviewAnswer = z.output<typeof previewAnswerSchema>;
+/** What the preview answered, or `kvbuilder/PREVIEW_FAILED` when it isn't kvman's envelope. */
+export declare function previewAnswer(body: unknown): PreviewAnswer;
+/** Runs one public query or command of the running preview, in its Home. */
+export declare function callPreview(ctx: Ctx, route: PreviewRoute, name: string, input: Record<string, unknown>): Promise<PreviewAnswer>;
+//# sourceMappingURL=preview-call.d.ts.map

package/dist/preview/preview-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-call.d.ts","sourceRoot":"","sources":["../../src/preview/preview-call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAQvD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,uFAAuF;AACvF,eAAO,MAAM,mBAAmB;;;;;;;;;;mBAG9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEjE,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAI1D;AAmBD,4EAA4E;AAC5E,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAGrI"}

package/dist/preview/preview-call.js

@@ -0,0 +1,39 @@
+import { ProblemError, z } from '@kvman/sdk';
+import { kvbuilderProblem } from "../problems.js";
+import { previewRecordSchema, recordKey } from "./preview-state.js";
+/** The preview's envelope without its job id: the output of a call, or its Problem. */
+export const previewAnswerSchema = z.union([
+    z.object({ ok: z.literal(true), output: z.json() }),
+    z.object({ ok: z.literal(false), problem: z.object({ code: z.string(), message: z.string(), params: z.record(z.string(), z.json()).exactOptional() }) }),
+]);
+/** What the preview answered, or `kvbuilder/PREVIEW_FAILED` when it isn't kvman's envelope. */
+export function previewAnswer(body) {
+    const parsed = previewAnswerSchema.safeParse(body);
+    if (!parsed.success)
+        throw kvbuilderProblem('PREVIEW_FAILED', "The preview's answer isn't one kvman gives.");
+    return parsed.data.ok ? { ok: true, output: parsed.data.output } : { ok: false, problem: parsed.data.problem };
+}
+async function previewUrl(ctx) {
+    const running = (await ctx.processes.list()).some((process) => process.name === 'preview');
+    const record = previewRecordSchema.safeParse(await ctx.store.kv.get(recordKey));
+    if (!running || !record.success)
+        throw new ProblemError({ code: 'NOT_FOUND', message: 'No preview is running; start one with preview start.' });
+    return record.data.url;
+}
+async function post(address, input, signal) {
+    try {
+        const response = await fetch(address, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ input }), signal });
+        return await response.json();
+    }
+    catch (error) {
+        if (error instanceof TypeError || error instanceof SyntaxError)
+            throw kvbuilderProblem('PREVIEW_FAILED', `The preview didn't answer the call: ${error.message}`);
+        throw error;
+    }
+}
+/** Runs one public query or command of the running preview, in its Home. */
+export async function callPreview(ctx, route, name, input) {
+    const address = new URL(`api/${route}/${encodeURIComponent(name)}`, await previewUrl(ctx));
+    return previewAnswer(await post(address, input, ctx.job.signal));
+}
+//# sourceMappingURL=preview-call.js.map