acrylblends 0.7.7 → 0.8.0

package/dist/index.d.ts

@@ -18,8 +18,10 @@ interface Io {
 interface AddOptions {
   readonly names: readonly string[];
   readonly directory: string | undefined;
+  /** Also copy the port's conformance suite (`src/conformance.ts`) and the `vitest` it runs on: what a provider of your own must pass. */
+  readonly suite: boolean;
 }
-/** Parse `add <plugin...> [--dir <app>]`. */
+/** Parse `add <plugin...> [--dir <app>] [--suite]`. */
 export declare function parseAddOptions(argv: readonly string[]): AddOptions;
 /**
  * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.
@@ -29,9 +31,11 @@ export declare function add(options: AddOptions, io: Io): Promise<number>;
 /** `acrylblends plugins`: the library, one line per plugin. */
 export declare function listPlugins(io: Io): number;
 //#endregion
-//#region src/cli.d.ts
+//#region src/version.d.ts
 /** The version of this package. */
 export declare const VERSION: string;
+//#endregion
+//#region src/cli.d.ts
 export declare const HELP: string;
 /**
  * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.
@@ -39,8 +43,8 @@ export declare const HELP: string;
 export declare function runCli(argv: readonly string[], io?: Io): Promise<number>;
 //#endregion
 //#region src/templates.d.ts
-/** The templates: a blank Cordis app on the router, a todo list built only on the router and state, and the blank app with the offline agent. */
-export declare const TEMPLATES: readonly ["blank", "todo", "agent"];
+/** The templates, all Cordis apps: a web app with a page and a client component (nodejs), a notes app and a chat app on the db port (notes, chat), a blank app on the router, a todo list on the router and state, and the blank app with the offline agent. */
+export declare const TEMPLATES: readonly ["nodejs", "notes", "chat", "blank", "todo", "agent"];
 type Template = (typeof TEMPLATES)[number];
 export declare function isTemplate(value: string): value is Template;
 /**
@@ -86,6 +90,10 @@ interface LibraryPlugin {
   readonly scripts?: Readonly<Record<string, string>>;
   /** Lines the app's `.gitignore` needs for this plugin (added when missing, if the app has a `.gitignore`). */
   readonly gitignore?: readonly string[];
+  /** The port's conformance suite, a path inside the plugin: shipped in the package, but copied into an app only by `acrylblends add <plugin> --suite` (it needs vitest). */
+  readonly suite?: string;
+  /** `package.json` "imports" entries the app gets (`#acryl-kv`): a path below the plugins folder. A plugin of your own imports the port by that name, in tests and the type-check as well as when installed live. */
+  readonly imports?: Readonly<Record<string, string>>;
   /** How to mount it, shown after `acrylblends add`. */
   readonly mount?: string;
   /**
@@ -102,7 +110,7 @@ export declare function libraryRoot(): string;
 export declare function readLibrary(root?: string): Map<string, LibraryPlugin>;
 /** The plugins to copy for `names`: each one after everything it requires, no duplicates. */
 export declare function closure(names: readonly string[], library: Map<string, LibraryPlugin>): LibraryPlugin[];
-/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */
+/** Copy one library plugin's source into `<app>/plugins/<name>/`. Throws when that folder already exists. */
 export declare function copyPlugin(plugin: LibraryPlugin, appDir: string, root?: string): string;
 //#endregion
 //#region src/project.d.ts
@@ -118,7 +126,7 @@ export declare function nameFrom(directory: string): string;
 /** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */
 export declare function assertTargetFree(target: string): void;
 /**
- * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.
+ * Copy a template into `target`, replacing `__APP_NAME__` with `name` and `__ACRYLBLENDS_RANGE__` with the range of this release. Checks the target before writing anything.
  *
  * @returns the copied files, relative to `target`
  */

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
@@ -84,20 +84,49 @@ function closure(names, library) {
 	for (const name of names) visit(name, []);
 	return ordered;
 }
-/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */
+/** The one folder every plugin of an app lives in, library copies and the ones an agent writes. */
+const PLUGINS_DIR = "plugins";
+/** Where apps made before 0.7.8 kept library copies; still understood for one release. */
+const LEGACY_PLUGINS_DIR = join("src", "plugins");
+/** The list of library copies in the plugins folder; the extensions plugin installs every other folder there. */
+const LIBRARY_LIST = "library.json";
+/** The plugins folder of an app: `plugins/`, or `src/plugins/` for an app that still has the old layout (and no `plugins/`). */
+function pluginsFolder(appDir) {
+	const legacy = existsSync(join(appDir, LEGACY_PLUGINS_DIR)) && !existsSync(join(appDir, "plugins"));
+	return {
+		dir: join(appDir, legacy ? LEGACY_PLUGINS_DIR : PLUGINS_DIR),
+		legacy
+	};
+}
+/** The warning for an app with the old layout. */
+const LEGACY_WARNING = "warning: this app keeps its plugins in src/plugins/ (and extensions/); plugins now live in one folder, plugins/. Move them with \"git mv src/plugins plugins\", fix the paths in tsconfig.json, package.json and src/, and see docs/framework/agents/index.md. The old layout is read for this release only.";
+function recordLibraryCopy(folder, name) {
+	const file = join(folder, LIBRARY_LIST);
+	const names = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")).plugins : [];
+	if (!names.includes(name)) names.push(name);
+	writeFileSync(file, `${JSON.stringify({ plugins: names.sort() }, null, 2)}\n`);
+}
+/** Copy one library plugin's source into `<app>/plugins/<name>/`. Throws when that folder already exists. */
 function copyPlugin(plugin, appDir, root = libraryRoot()) {
-	const target = join(appDir, "src", "plugins", plugin.name);
-	if (existsSync(target)) throw new LibraryError(`src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`);
+	const folder = pluginsFolder(appDir);
+	const target = join(folder.dir, plugin.name);
+	if (existsSync(target)) throw new LibraryError(`${relativeName(appDir, target)} already exists; remove it first to copy a fresh one`);
 	const source = join(root, plugin.name);
 	cpSync(source, target, {
 		recursive: true,
 		filter: (path) => {
 			const inside = path.slice(source.length + 1);
-			return !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit);
+			return !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit) && inside.split(sep).join("/") !== plugin.suite;
 		}
 	});
+	if (!folder.legacy) recordLibraryCopy(folder.dir, plugin.name);
 	return target;
 }
+const relativeName = (appDir, path) => path.slice(appDir.length + 1).split(sep).join("/");
+//#endregion
+//#region src/version.ts
+/** The version of this package. */
+const VERSION = createRequire(import.meta.url)("../package.json").version;
 //#endregion
 //#region src/project.ts
 /** Thrown when the target directory exists and is not empty. Nothing has been written. */
@@ -123,7 +152,7 @@ function assertTargetFree(target) {
 	if (!statSync(target).isDirectory() || readdirSync(target).length > 0) throw new TargetNotEmptyError(target);
 }
 /**
-* Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.
+* Copy a template into `target`, replacing `__APP_NAME__` with `name` and `__ACRYLBLENDS_RANGE__` with the range of this release. Checks the target before writing anything.
 *
 * @returns the copied files, relative to `target`
 */
@@ -143,7 +172,7 @@ function copyTemplate(source, target, name) {
 				continue;
 			}
 			const text = readFileSync(sourcePath, "utf8");
-			if (text.includes("__APP_NAME__")) writeFileSync(targetPath, text.replaceAll("__APP_NAME__", name));
+			if (text.includes("__APP_NAME__") || text.includes("__ACRYLBLENDS_RANGE__")) writeFileSync(targetPath, text.replaceAll("__APP_NAME__", name).replaceAll("__ACRYLBLENDS_RANGE__", `^${VERSION}`));
 			else cpSync(sourcePath, targetPath);
 			written.push(`${prefix}${targetName}`);
 		}
@@ -159,7 +188,7 @@ function readTemplateDesktopPath(templateDir) {
 	if (!existsSync(file)) return void 0;
 	return JSON.parse(readFileSync(file, "utf8")).desktopPath;
 }
-/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `src/plugins/desktop/main.ts`. */
+/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `plugins/desktop/main.ts`. */
 function writeDesktopPath(appDir, path) {
 	const file = join(appDir, "package.json");
 	const manifest = JSON.parse(readFileSync(file, "utf8"));
@@ -189,6 +218,19 @@ function mergeDependencies(appDir, dependencies) {
 	writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\n`);
 	return added;
 }
+/** Add `package.json` "imports" entries (`#acryl-kv`: `./plugins/acryl-kv/src/index.ts`); an entry the app already has is kept. Returns the names added. */
+function mergeImports(appDir, imports, pluginsDir) {
+	const file = join(appDir, "package.json");
+	const manifest = JSON.parse(readFileSync(file, "utf8"));
+	const current = manifest.imports ?? {};
+	const added = Object.keys(imports).filter((name) => !(name in current));
+	manifest.imports = {
+		...Object.fromEntries(Object.entries(imports).map(([name, path]) => [name, `./${pluginsDir}/${path}`])),
+		...current
+	};
+	writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\n`);
+	return added;
+}
 /** Declare a file as an opener in package.json (`"acryl": { "opener": [...] }`): the one place that may import a database provider. */
 function mergeOpener(appDir, opener) {
 	const file = join(appDir, "package.json");
@@ -241,9 +283,17 @@ function appendGitignore(appDir, lines) {
 function writeAgentFiles(sharedDir, templateDir, target, name) {
 	const core = readFileSync(join(sharedDir, "AGENTS.core.md"), "utf8");
 	const own = existsSync(join(templateDir, "AGENTS.md")) ? readFileSync(join(templateDir, "AGENTS.md"), "utf8") : "";
-	writeFileSync(join(target, "AGENTS.md"), `${core}${own}`.replaceAll("__APP_NAME__", name));
-	writeFileSync(join(target, "CLAUDE.md"), "@AGENTS.md\n");
-	return ["AGENTS.md", "CLAUDE.md"];
+	const text = `${core}${readFileSync(join(sharedDir, "DEFAULTS.md"), "utf8")}${own}`.replaceAll("__APP_NAME__", name);
+	writeFileSync(join(target, "AGENTS.md"), text);
+	writeFileSync(join(target, "CLAUDE.md"), text);
+	const skill = readFileSync(join(sharedDir, "SKILL.md"), "utf8").replaceAll("__APP_NAME__", name);
+	const written = ["AGENTS.md", "CLAUDE.md"];
+	for (const folder of [".claude/skills/app-guide", ".agents/skills/app-guide"]) {
+		mkdirSync(join(target, folder), { recursive: true });
+		writeFileSync(join(target, folder, "SKILL.md"), skill);
+		written.push(`${folder}/SKILL.md`);
+	}
+	return written;
 }
 /**
 * Copy the framework's docs (a generated copy of ACRYL's `docs/framework`, already checked against its digest) into `<app>/docs/framework/`,
@@ -273,8 +323,11 @@ function copyFrameworkDocs(source, target) {
 }
 //#endregion
 //#region src/templates.ts
-/** The templates: a blank Cordis app on the router, a todo list built only on the router and state, and the blank app with the offline agent. */
+/** The templates, all Cordis apps: a web app with a page and a client component (nodejs), a notes app and a chat app on the db port (notes, chat), a blank app on the router, a todo list on the router and state, and the blank app with the offline agent. */
 const TEMPLATES = [
+	"nodejs",
+	"notes",
+	"chat",
 	"blank",
 	"todo",
 	"agent"
@@ -394,6 +447,7 @@ async function init(options, io) {
 	const plugins = closure([...readTemplatePlugins(templateDir(template)), ...options.desktop ? ["desktop"] : []], readLibrary());
 	for (const plugin of plugins) {
 		copyPlugin(plugin, directory);
+		if (plugin.imports) mergeImports(directory, plugin.imports, "plugins");
 		mergeDependencies(directory, plugin.dependencies);
 		mergeTooling(directory, plugin);
 	}
@@ -414,7 +468,7 @@ async function init(options, io) {
 }
 //#endregion
 //#region src/add.ts
-/** Parse `add <plugin...> [--dir <app>]`. */
+/** Parse `add <plugin...> [--dir <app>] [--suite]`. */
 function parseAddOptions(argv) {
 	let parsed;
 	try {
@@ -425,16 +479,20 @@ function parseAddOptions(argv) {
 	if (parsed.positionals.length === 0) throw new UsageError("add needs at least one plugin name (see \"acrylblends plugins\")");
 	return {
 		names: parsed.positionals,
-		directory: parsed.values.dir
+		directory: parsed.values.dir,
+		suite: parsed.values.suite === true
 	};
 }
 const parse$1 = (argv) => parseArgs({
 	args: [...argv],
 	allowPositionals: true,
 	strict: true,
-	options: { dir: { type: "string" } }
+	options: {
+		dir: { type: "string" },
+		suite: { type: "boolean" }
+	}
 });
-const present = (appDir, name) => existsSync(join(appDir, "src", "plugins", name));
+const present = (appDir, name) => existsSync(join(pluginsFolder(appDir).dir, name));
 /**
 * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.
 * Refuses a plugin the app already has. Returns the exit code.
@@ -445,12 +503,13 @@ async function add(options, io) {
 		io.stderr.write(`error: ${appDir} is not an app (no package.json and src/); run "acrylblends init" first\n`);
 		return 1;
 	}
+	if (pluginsFolder(appDir).legacy) io.stderr.write(`${LEGACY_WARNING}\n`);
 	const external = options.names.filter((name) => /[\\/]/.test(name) || name.startsWith("."));
 	for (const folder of external) {
 		const code = addExternal(resolve(io.cwd, folder), appDir, io);
 		if (code !== 0) return code;
 	}
-	const plain = !existsSync(join(appDir, "src", "plugins", "instance"));
+	const plain = !existsSync(join(pluginsFolder(appDir).dir, "instance"));
 	if (plain && options.names.includes("db")) {
 		io.stderr.write("error: \"db\" is the Cordis plugin for a Blend app. A plain Acryl app opens its database with openDb from \"acrylblends/db/sqlite\" (see docs/framework/guides/data.md)\n");
 		return 1;
@@ -461,15 +520,16 @@ async function add(options, io) {
 	}
 	const names = options.names.filter((name) => !external.includes(name)).map((name) => name === "db" ? "acryl-db-sqlite" : name).map((name) => name === "kv" ? "acryl-kv-json" : name).map((name) => name === "desktop" && plain ? "desktop-web" : name);
 	if (names.length === 0) return 0;
-	const already = names.filter((name) => present(appDir, name));
+	const already = options.suite ? [] : names.filter((name) => present(appDir, name));
 	if (already.length > 0) {
-		io.stderr.write(`error: the app already has ${already.map((name) => `src/plugins/${name}`).join(", ")}\n`);
+		io.stderr.write(`error: the app already has ${already.map((name) => `${relative(appDir, join(pluginsFolder(appDir).dir, name)).split(sep).join("/")}`).join(", ")}\n`);
 		return 1;
 	}
 	const toCopy = closure(names, readLibrary()).filter((plugin) => !present(appDir, plugin.name));
 	const addedDependencies = [];
 	for (const plugin of toCopy) {
 		copyPlugin(plugin, appDir);
+		if (plugin.imports) mergeImports(appDir, plugin.imports, relative(appDir, pluginsFolder(appDir).dir).split(sep).join("/"));
 		addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies));
 		const tooling = mergeTooling(appDir, plugin);
 		appendGitignore(appDir, plugin.gitignore);
@@ -477,15 +537,49 @@ async function add(options, io) {
 		addedDependencies.push(...tooling.devDependencies);
 		if (tooling.scripts.length > 0) io.stdout.write(`new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(", ")}\n`);
 	}
+	if (options.suite) {
+		const refused = copySuites(names, appDir, addedDependencies, io);
+		if (refused !== 0) return refused;
+	}
 	io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(", ")} to ${appDir}\n`);
 	if (addedDependencies.length > 0) io.stdout.write(`new dependencies: ${addedDependencies.join(", ")} (run npm install)\n`);
-	for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) io.stdout.write(`\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\n`);
+	for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) io.stdout.write(`\n${plugin.name}: ${plugin.mount ?? `import it from '../plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\n`);
+	return 0;
+}
+/** The vitest the suites run on (the version this package is tested with). */
+const SUITE_RUNNER = { vitest: "5.0.3" };
+/**
+* Copy the conformance suite of each named port next to its source (`plugins/<name>/src/conformance.ts`), and add `vitest` to the app's development
+* dependencies. The suite is left out of a normal copy because an app that only uses a port has no use for it. Returns the exit code: 1 when a plugin has none.
+*/
+function copySuites(names, appDir, added, io) {
+	const copies = [];
+	const ports = [...new Set(names.map((name) => name.replace(/^(acryl-(?:kv|db))(?:-.*)?$/u, "$1")))];
+	const library = readLibrary();
+	for (const name of ports) {
+		const suite = library.get(name)?.suite;
+		const from = suite === void 0 ? "" : join(libraryRoot(), name, suite);
+		if (suite === void 0 || !existsSync(from)) {
+			io.stderr.write(`error: ${name} has no conformance suite (the ports db and kv do)\n`);
+			return 1;
+		}
+		copies.push({
+			from,
+			to: join(pluginsFolder(appDir).dir, name, suite)
+		});
+	}
+	for (const { from, to } of copies) {
+		mkdirSync(dirname(to), { recursive: true });
+		copyFileSync(from, to);
+		io.stdout.write(`added the conformance suite ${relative(appDir, to).split(sep).join("/")}\n`);
+	}
+	added.push(...mergeTooling(appDir, { devDependencies: SUITE_RUNNER }).devDependencies);
 	return 0;
 }
 const PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
 /**
 * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a
-* Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,
+* Cordis plugin) into the app's `plugins/`, where the extensions plugin installs it like any other: checked, staged, started,
 * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.
 */
 function addExternal(folder, appDir, io) {
@@ -508,16 +602,16 @@ function addExternal(folder, appDir, io) {
 		io.stderr.write(`error: "${name}" is not a plugin name (lowercase letters, digits and dashes)\n`);
 		return 1;
 	}
-	const target = join(appDir, "extensions", name);
+	const target = join(pluginsFolder(appDir).legacy ? join(appDir, "extensions") : join(appDir, PLUGINS_DIR), name);
 	if (existsSync(target)) {
-		io.stderr.write(`error: the app already has extensions/${name}\n`);
+		io.stderr.write(`error: the app already has ${relative(appDir, target).split(sep).join("/")}\n`);
 		return 1;
 	}
 	cpSync(folder, target, {
 		recursive: true,
 		filter: (path) => !/[\\/](node_modules|\.git)([\\/]|$)/.test(path.slice(folder.length))
 	});
-	io.stdout.write(`added external plugin ${name} to ${join(appDir, "extensions")}; it installs at the next start\n`);
+	io.stdout.write(`added external plugin ${name} to ${dirname(target)}; it installs at the next start\n`);
 	const dependencies = Object.keys(manifest.dependencies ?? {});
 	if (dependencies.length > 0) io.stdout.write(`it uses ${dependencies.join(", ")}: add them to the app with npm install first\n`);
 	return 0;
@@ -596,9 +690,14 @@ const DRIVERS = [
 const OPENERS = ["acrylblends/db/sqlite", "acryl-db-sqlite"];
 /** The desktop shell is where Electron lives (`acrylblends add desktop` copies it). */
 const ELECTRON = "electron";
-const ELECTRON_HOMES = ["src/plugins/desktop/", "src/plugins/desktop-web/"];
+const ELECTRON_HOMES = [
+	"plugins/desktop/",
+	"plugins/desktop-web/",
+	"src/plugins/desktop/",
+	"src/plugins/desktop-web/"
+];
 /** The provider plugins themselves may import what they wrap. */
-const PROVIDER_HOMES = ["src/plugins/acryl-db-sqlite/"];
+const PROVIDER_HOMES = ["plugins/acryl-db-sqlite/", "src/plugins/acryl-db-sqlite/"];
 const SOURCE = /\.(?:[cm]?[jt]s|[jt]sx)$/u;
 const SKIP_DIRS = /* @__PURE__ */ new Set([
 	"node_modules",
@@ -611,6 +710,7 @@ const ROOTS = [
 	"src",
 	"test",
 	"tests",
+	"plugins",
 	"extensions"
 ];
 const matches = (specifier, name) => specifier === name || specifier.startsWith(`${name}/`);
@@ -709,7 +809,7 @@ function findViolations(appDir) {
 }
 const GUIDE = "docs/framework/guides/data.md#why-the-database-is-opened-in-one-place";
 function advice(violation, openers) {
-	if (violation.kind === "electron") return `"${violation.specifier}" is the desktop shell's: only src/plugins/desktop (added with "acrylblends add desktop") imports electron`;
+	if (violation.kind === "electron") return `"${violation.specifier}" is the desktop shell's: only plugins/desktop (added with "acrylblends add desktop") imports electron`;
 	const where = openers.length > 0 ? openers.join(", ") : "a file named in package.json \"acryl\": { \"opener\": \"...\" }";
 	return violation.kind === "driver" ? `"${violation.specifier}" is a database driver; take a Db (import type { Db } from "acrylblends/db") as an argument and let ${where} open the database` : `"${violation.specifier}" opens a database, and only ${where} may; take a Db (import type { Db } from "acrylblends/db") as an argument`;
 }
@@ -871,14 +971,13 @@ async function kvImport(options, io) {
 }
 //#endregion
 //#region src/cli.ts
-/** The version of this package. */
-const VERSION = createRequire(import.meta.url)("../package.json").version;
 const HELP = `acrylblends ${VERSION} - scaffold Cordis apps
 
 Usage:
   acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory
-  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;
-                                      a folder path brings an external plugin into its extensions/
+  acrylblends add <plugin...> [--dir d] [--suite]  Copy library plugins (and what they require) into an app;
+                                      a folder path brings an external plugin into its plugins/;
+                                      --suite also copies the port's conformance suite and vitest (add kv --suite)
   acrylblends plugins                    List the plugin library
   acrylblends build-client [root] [out]  Compile the client modules once for production (src/client to dist/client)
   acrylblends kv import <kv.json> <db>   Move a JSON-file kv store into the kv table of a SQLite database [--overwrite] [--table t] [--migrations dir]