acrylblends 0.7.5 → 0.7.7

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["parse"],"sources":["../src/library.ts","../src/project.ts","../src/templates.ts","../src/init.ts","../src/add.ts","../src/build-client.ts","../src/spawn.ts","../src/io.ts","../src/cli.ts"],"sourcesContent":["import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */\nexport interface LibraryPlugin {\n  readonly name: string\n  readonly description: string\n  /** Library plugins this one imports; they are copied with it. */\n  readonly requires: readonly string[]\n  /** npm packages an app needs at run time for this plugin. */\n  readonly dependencies: Readonly<Record<string, string>>\n  /** npm packages an app needs only to develop or run this plugin's tooling (for example `electron` for the desktop shell). */\n  readonly devDependencies?: Readonly<Record<string, string>>\n  /** `package.json` scripts the plugin adds; a script the app already has is kept. */\n  readonly scripts?: Readonly<Record<string, string>>\n  /** Lines the app's `.gitignore` needs for this plugin (added when missing, if the app has a `.gitignore`). */\n  readonly gitignore?: readonly string[]\n  /** How to mount it, shown after `acrylblends add`. */\n  readonly mount?: string\n  /**\n   * Paths inside the plugin folder that are not copied into an app (for example a React hook an app without React cannot type-check, or colocated test\n   * files). A pattern is an exact path or a glob: `*` matches within one folder name, `**` across folders, `?` one character; `**` followed by a slash also matches no folder.\n   */\n  readonly omit?: readonly string[]\n}\n\n/** A glob as a regular expression: `*` within a name, `**` across folders, `**` plus a slash may match no folder, `?` one character. */\nfunction globToRegExp(glob: string): RegExp {\n  let source = ''\n  for (let i = 0; i < glob.length; i += 1) {\n    const c = glob[i] as string\n    if (c === '*' && glob[i + 1] === '*') {\n      if (glob[i + 2] === '/') {\n        source += '(?:.*/)?'\n        i += 2\n      } else {\n        source += '.*'\n        i += 1\n      }\n    } else if (c === '*') source += '[^/]*'\n    else if (c === '?') source += '[^/]'\n    else source += c.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n  }\n  return new RegExp(`^${source}$`)\n}\n\n/** Whether a path inside a plugin folder (relative, any separator) is named by one of its `omit` patterns. */\nexport function isOmitted(inside: string, patterns: readonly string[] | undefined): boolean {\n  if (!patterns || patterns.length === 0) return false\n  const path = inside.split(sep).join('/')\n  return patterns.some((pattern) =>\n    /[*?]/.test(pattern) ? globToRegExp(pattern).test(path) : pattern === path,\n  )\n}\n\n/** Files of a library plugin that stay in the repository: its manifest and its tests. */\nconst LIBRARY_ONLY = new Set(['plugin.json', 'test', 'tests'])\n\nexport class LibraryError extends Error {\n  override name = 'LibraryError'\n}\n\n/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */\nexport function libraryRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'plugins')\n    if (existsSync(join(candidate, 'instance', 'plugin.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new LibraryError('acrylblends cannot find its plugin library (plugins/)')\n    dir = parent\n  }\n}\n\n/** Every plugin in the library, by name. */\nexport function readLibrary(root: string = libraryRoot()): Map<string, LibraryPlugin> {\n  const plugins = new Map<string, LibraryPlugin>()\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    const manifest = join(root, entry.name, 'plugin.json')\n    if (!entry.isDirectory() || !existsSync(manifest)) continue\n    const plugin = JSON.parse(readFileSync(manifest, 'utf8')) as LibraryPlugin\n    if (plugin.name !== entry.name)\n      throw new LibraryError(`plugins/${entry.name}/plugin.json names \"${plugin.name}\"`)\n    plugins.set(plugin.name, {\n      ...plugin,\n      requires: plugin.requires ?? [],\n      dependencies: plugin.dependencies ?? {},\n    })\n  }\n  return plugins\n}\n\n/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */\nexport function closure(\n  names: readonly string[],\n  library: Map<string, LibraryPlugin>,\n): LibraryPlugin[] {\n  const ordered: LibraryPlugin[] = []\n  const visiting = new Set<string>()\n  const visit = (name: string, trail: string[]) => {\n    if (ordered.some((plugin) => plugin.name === name)) return\n    const plugin = library.get(name)\n    if (!plugin)\n      throw new LibraryError(\n        `no plugin \"${name}\" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ''}`,\n      )\n    if (visiting.has(name))\n      throw new LibraryError(\n        `plugins require each other in a cycle: ${[...trail, name].join(' -> ')}`,\n      )\n    visiting.add(name)\n    for (const required of plugin.requires) visit(required, [...trail, name])\n    visiting.delete(name)\n    ordered.push(plugin)\n  }\n  for (const name of names) visit(name, [])\n  return ordered\n}\n\n/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */\nexport function copyPlugin(\n  plugin: LibraryPlugin,\n  appDir: string,\n  root: string = libraryRoot(),\n): string {\n  const target = join(appDir, 'src', 'plugins', plugin.name)\n  if (existsSync(target))\n    throw new LibraryError(\n      `src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`,\n    )\n  const source = join(root, plugin.name)\n  cpSync(source, target, {\n    recursive: true,\n    filter: (path) => {\n      const inside = path.slice(source.length + 1)\n      return (\n        !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit)\n      )\n    },\n  })\n  return target\n}\n","import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs'\nimport { join } from 'node:path'\n\n/** Thrown when the target directory exists and is not empty. Nothing has been written. */\nexport class TargetNotEmptyError extends Error {\n  constructor(readonly target: string) {\n    super(\n      `refusing to write into \"${target}\": the directory is not empty. Choose an empty or new directory.`,\n    )\n    this.name = 'TargetNotEmptyError'\n  }\n}\n\n/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */\nexport function isValidName(name: string): boolean {\n  return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214\n}\n\n/** A valid default project name derived from a directory path. */\nexport function nameFrom(directory: string): string {\n  const base = directory.split(/[\\\\/]/).filter(Boolean).pop() ?? ''\n  const cleaned = base\n    .toLowerCase()\n    .replace(/[^a-z0-9-]+/g, '-')\n    .replace(/^[^a-z]+/, '')\n    .replace(/-+$/, '')\n  return cleaned || 'my-app'\n}\n\n/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */\nexport function assertTargetFree(target: string): void {\n  if (!existsSync(target)) return\n  if (!statSync(target).isDirectory() || readdirSync(target).length > 0)\n    throw new TargetNotEmptyError(target)\n}\n\n/**\n * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyTemplate(source: string, target: string, name: string): string[] {\n  assertTargetFree(target)\n  mkdirSync(target, { recursive: true })\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (\n        entry.name === 'node_modules' ||\n        (prefix === '' &&\n          (entry.name === TEMPLATE_MANIFEST ||\n            entry.name === 'upstream.json' ||\n            entry.name === 'AGENTS.md'))\n      )\n        continue\n      const sourcePath = join(from, entry.name)\n      // npm and git treat a file named .gitignore specially, so templates keep it as `gitignore` (and `dockerignore`).\n      const targetName =\n        prefix === '' && (entry.name === 'gitignore' || entry.name === 'dockerignore')\n          ? `.${entry.name}`\n          : entry.name\n      const targetPath = join(to, targetName)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      const text = readFileSync(sourcePath, 'utf8')\n      if (text.includes('__APP_NAME__'))\n        writeFileSync(targetPath, text.replaceAll('__APP_NAME__', name))\n      else cpSync(sourcePath, targetPath)\n      written.push(`${prefix}${targetName}`)\n    }\n  }\n  walk(source, target, '')\n  return written\n}\n\n/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied (nor is `upstream.json`, the record of what was synced from ACRYL, nor the template's `AGENTS.md`, which `writeAgentFiles` joins to the shared core). */\nexport const TEMPLATE_MANIFEST = 'template.json'\n\n/** The address a template's desktop window opens on, when it is not the root (`template.json`: `desktopPath`). */\nexport function readTemplateDesktopPath(templateDir: string): string | undefined {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return undefined\n  return (JSON.parse(readFileSync(file, 'utf8')) as { desktopPath?: string }).desktopPath\n}\n\n/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `src/plugins/desktop/main.ts`. */\nexport function writeDesktopPath(appDir: string, path: string): void {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    acrylblends?: Record<string, unknown>\n  }\n  manifest.acrylblends = { ...manifest.acrylblends, desktopPath: path }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n}\n\nexport function readTemplatePlugins(templateDir: string): string[] {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return []\n  const { plugins } = JSON.parse(readFileSync(file, 'utf8')) as { plugins?: string[] }\n  return plugins ?? []\n}\n\n/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */\nexport function mergeDependencies(\n  appDir: string,\n  dependencies: Readonly<Record<string, string>>,\n): string[] {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    dependencies?: Record<string, string>\n  }\n  const current = manifest.dependencies ?? {}\n  const added = Object.keys(dependencies).filter((name) => !(name in current))\n  const merged = { ...dependencies, ...current }\n  manifest.dependencies = Object.fromEntries(\n    Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return added\n}\n\n/**\n * Add a plugin's development dependencies and scripts to an app's package.json: nothing the app already has is replaced. Returns the names of the development dependencies\n * and scripts added.\n */\nexport function mergeTooling(\n  appDir: string,\n  tooling: {\n    devDependencies?: Readonly<Record<string, string>> | undefined\n    scripts?: Readonly<Record<string, string>> | undefined\n  },\n): { devDependencies: string[]; scripts: string[] } {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    devDependencies?: Record<string, string>\n    scripts?: Record<string, string>\n  }\n  const dev = manifest.devDependencies ?? {}\n  const scripts = manifest.scripts ?? {}\n  const addedDev = Object.keys(tooling.devDependencies ?? {}).filter((name) => !(name in dev))\n  const addedScripts = Object.keys(tooling.scripts ?? {}).filter((name) => !(name in scripts))\n  manifest.devDependencies = Object.fromEntries(\n    Object.entries({ ...tooling.devDependencies, ...dev }).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  manifest.scripts = { ...tooling.scripts, ...scripts }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return { devDependencies: addedDev, scripts: addedScripts }\n}\n\n/** Add the lines a plugin needs to the app's `.gitignore` when it has one and they are missing. Returns the lines added. */\nexport function appendGitignore(appDir: string, lines: readonly string[] | undefined): string[] {\n  const file = join(appDir, '.gitignore')\n  if (!lines || lines.length === 0 || !existsSync(file)) return []\n  const current = readFileSync(file, 'utf8')\n  const present = new Set(current.split('\\n').map((line) => line.trim()))\n  const missing = lines.filter((line) => !present.has(line))\n  if (missing.length > 0)\n    writeFileSync(\n      file,\n      `${current}${current.endsWith('\\n') || current === '' ? '' : '\\n'}${missing.join('\\n')}\\n`,\n    )\n  return missing\n}\n\n/** The generated app's guide for a coding agent: the shared core, then the template's own part. `CLAUDE.md` is only an import of it. */\nexport function writeAgentFiles(\n  sharedDir: string,\n  templateDir: string,\n  target: string,\n  name: string,\n): string[] {\n  const core = readFileSync(join(sharedDir, 'AGENTS.core.md'), 'utf8')\n  const own = existsSync(join(templateDir, 'AGENTS.md'))\n    ? readFileSync(join(templateDir, 'AGENTS.md'), 'utf8')\n    : ''\n  writeFileSync(join(target, 'AGENTS.md'), `${core}${own}`.replaceAll('__APP_NAME__', name))\n  writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\\n')\n  return ['AGENTS.md', 'CLAUDE.md']\n}\n\n/**\n * Copy the framework's docs (a generated copy of ACRYL's `docs/framework`, already checked against its digest) into `<app>/docs/framework/`,\n * so a coding agent working in the app reads the API from the folder it is in. The generated-copy notes and the digest record stay behind.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyFrameworkDocs(source: string, target: string): string[] {\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (entry.name === 'upstream.json' || entry.name === 'UPSTREAM.md') continue\n      const sourcePath = join(from, entry.name)\n      const targetPath = join(to, entry.name)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      cpSync(sourcePath, targetPath)\n      written.push(`docs/framework/${prefix}${entry.name}`)\n    }\n  }\n  mkdirSync(join(target, 'docs', 'framework'), { recursive: true })\n  walk(source, join(target, 'docs', 'framework'), '')\n  return written\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** 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. */\nexport const TEMPLATES = ['blank', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\n\nexport function isTemplate(value: string): value is Template {\n  return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/**\n * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build\n * (`dist/`), so walk up until a `templates` folder holds the `blank` template.\n */\nexport function templatesRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'templates')\n    if (existsSync(join(candidate, 'blank'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) throw new Error('acrylblends cannot find its templates folder')\n    dir = parent\n  }\n}\n\n/** Absolute path of a template folder. */\nexport function templateDir(template: Template): string {\n  return join(templatesRoot(), template)\n}\n\n/** The text every generated app's `AGENTS.md` starts with (`shared/`, beside `templates/`). */\nexport function sharedDir(): string {\n  return join(dirname(templatesRoot()), 'shared')\n}\n\n/**\n * The framework's docs, as ACRYL wrote them: `docs/framework` of the repository, or the copy `prepack` puts inside the package. The module sits at\n * different depths in source and in the build, so walk up until a `docs/framework` folder holds the README.\n */\nexport function frameworkDocsRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'docs', 'framework')\n    if (existsSync(join(candidate, 'README.md'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new Error('acrylblends cannot find the framework docs (docs/framework)')\n    dir = parent\n  }\n}\n","import { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport type { Io } from './io'\nimport { closure, copyPlugin, readLibrary } from './library'\nimport {\n  copyFrameworkDocs,\n  copyTemplate,\n  isValidName,\n  mergeDependencies,\n  mergeTooling,\n  nameFrom,\n  readTemplateDesktopPath,\n  readTemplatePlugins,\n  TargetNotEmptyError,\n  writeAgentFiles,\n  writeDesktopPath,\n} from './project'\nimport {\n  frameworkDocsRoot,\n  isTemplate,\n  sharedDir,\n  TEMPLATES,\n  type Template,\n  templateDir,\n} from './templates'\n\n/** A command line mistake. The CLI prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n  override name = 'UsageError'\n}\n\n/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */\nexport interface InitOptions {\n  directory: string | undefined\n  name: string | undefined\n  template: Template | undefined\n  install: boolean | undefined\n  /** Also add the desktop shell (`add desktop`): an Electron window on the app's own server. */\n  desktop: boolean\n  yes: boolean\n}\n\n/** Parse `init [dir] [--template t] [--agent|--no-agent] [--name n] [--install] [-y]`. `--agent` means `--template agent`, `--no-agent` means `--template blank`. */\nexport function parseInitOptions(argv: readonly string[]): InitOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const { values, positionals } = parsed\n  if (positionals.length > 1) throw new UsageError('init takes at most one directory')\n  if (values.agent && values['no-agent'])\n    throw new UsageError('use --agent or --no-agent, not both')\n  if (values.template !== undefined && !isTemplate(values.template))\n    throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n  const alias: Template | undefined = values.agent\n    ? 'agent'\n    : values['no-agent']\n      ? 'blank'\n      : undefined\n  if (values.template !== undefined && alias !== undefined && values.template !== alias)\n    throw new UsageError(\n      `--template ${values.template} contradicts --${alias === 'agent' ? 'agent' : 'no-agent'}`,\n    )\n  return {\n    directory: positionals[0],\n    name: values.name,\n    template: (values.template as Template | undefined) ?? alias,\n    install: values.install,\n    desktop: values.desktop === true,\n    yes: values.yes === true,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      name: { type: 'string' },\n      template: { type: 'string' },\n      agent: { type: 'boolean' },\n      'no-agent': { type: 'boolean' },\n      install: { type: 'boolean' },\n      desktop: { type: 'boolean' },\n      yes: { type: 'boolean', short: 'y' },\n    },\n  })\n\nconst yes = (answer: string) => ['y', 'yes'].includes(answer.trim().toLowerCase())\n\nasync function askTemplate(ask: (question: string) => Promise<string>): Promise<Template> {\n  const answer = (await ask(`Template (${TEMPLATES.join(', ')}) [blank]: `)).trim().toLowerCase()\n  if (answer === '') return 'blank'\n  if (isTemplate(answer)) return answer\n  throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n}\n\n/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */\nexport async function init(options: InitOptions, io: Io): Promise<number> {\n  const relative = options.directory ?? '.'\n  const directory = resolve(io.cwd, relative)\n  const ask = options.yes ? undefined : io.ask\n\n  let name = options.name ?? nameFrom(directory)\n  if (options.name === undefined && ask)\n    name = (await ask(`Project name (${name}): `)).trim() || name\n  if (!isValidName(name)) {\n    throw new UsageError(\n      `\"${name}\" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`,\n    )\n  }\n  const template = options.template ?? (ask ? await askTemplate(ask) : 'blank')\n  const install =\n    options.install ?? (ask ? yes(await ask('Install dependencies with npm now? (y/N): ')) : false)\n\n  let files: string[]\n  try {\n    files = copyTemplate(templateDir(template), directory, name)\n    files.push(...writeAgentFiles(sharedDir(), templateDir(template), directory, name))\n    files.push(...copyFrameworkDocs(frameworkDocsRoot(), directory))\n  } catch (error) {\n    if (!(error instanceof TargetNotEmptyError)) throw error\n    io.stderr.write(`error: ${error.message}\\n`)\n    return 1\n  }\n  const plugins = closure(\n    [...readTemplatePlugins(templateDir(template)), ...(options.desktop ? ['desktop'] : [])],\n    readLibrary(),\n  )\n  for (const plugin of plugins) {\n    copyPlugin(plugin, directory)\n    mergeDependencies(directory, plugin.dependencies)\n    mergeTooling(directory, plugin)\n  }\n  const desktopPath = options.desktop ? readTemplateDesktopPath(templateDir(template)) : undefined\n  if (desktopPath !== undefined) writeDesktopPath(directory, desktopPath)\n  io.stdout.write(\n    `created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(', ')}\\n`,\n  )\n\n  if (install && (await io.install(directory)) !== 0) {\n    io.stderr.write('error: npm install failed; run it yourself in the new directory\\n')\n    return 1\n  }\n  const steps = [\n    relative === '.' ? '' : `  cd ${relative}\\n`,\n    install ? '' : '  npm install\\n',\n    '  npm run dev\\n  npm test\\n',\n  ]\n  io.stdout.write(`\\nNext:\\n${steps.join('')}`)\n  return 0\n}\n","import { cpSync, existsSync, readFileSync, statSync } from 'node:fs'\nimport { basename, join, resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\nimport { closure, copyPlugin, type LibraryPlugin, readLibrary } from './library'\nimport { appendGitignore, mergeDependencies, mergeTooling } from './project'\n\nexport interface AddOptions {\n  readonly names: readonly string[]\n  readonly directory: string | undefined\n}\n\n/** Parse `add <plugin...> [--dir <app>]`. */\nexport function parseAddOptions(argv: readonly string[]): AddOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  if (parsed.positionals.length === 0)\n    throw new UsageError('add needs at least one plugin name (see \"acrylblends plugins\")')\n  return { names: parsed.positionals, directory: parsed.values.dir }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: { dir: { type: 'string' } },\n  })\n\nconst present = (appDir: string, name: string) => existsSync(join(appDir, 'src', 'plugins', name))\n\n/**\n * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.\n * Refuses a plugin the app already has. Returns the exit code.\n */\nexport async function add(options: AddOptions, io: Io): Promise<number> {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  if (!existsSync(join(appDir, 'package.json')) || !existsSync(join(appDir, 'src'))) {\n    io.stderr.write(\n      `error: ${appDir} is not an app (no package.json and src/); run \"acrylblends init\" first\\n`,\n    )\n    return 1\n  }\n  // A path is an external plugin folder; anything else is a library plugin name.\n  const external = options.names.filter((name) => /[\\\\/]/.test(name) || name.startsWith('.'))\n  for (const folder of external) {\n    const code = addExternal(resolve(io.cwd, folder), appDir, io)\n    if (code !== 0) return code\n  }\n  // The desktop shell has two forms: the Blend app (it needs the `instance` plugin) and a plain Acryl app (`export default app`); `desktop` means the one that fits.\n  const plain = !existsSync(join(appDir, 'src', 'plugins', 'instance'))\n  if (plain && options.names.includes('db')) {\n    io.stderr.write(\n      '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',\n    )\n    return 1\n  }\n  const names = options.names\n    .filter((name) => !external.includes(name))\n    // `db` is the SQLite provider of the db port (it brings the port); a plain app opens its database with `acrylblends/db/sqlite` instead.\n    .map((name) => (name === 'db' ? 'acryl-db-sqlite' : name))\n    .map((name) => (name === 'desktop' && plain ? 'desktop-web' : name))\n  if (names.length === 0) return 0\n  const already = names.filter((name) => present(appDir, name))\n  if (already.length > 0) {\n    io.stderr.write(\n      `error: the app already has ${already.map((name) => `src/plugins/${name}`).join(', ')}\\n`,\n    )\n    return 1\n  }\n  const toCopy: LibraryPlugin[] = closure(names, readLibrary()).filter(\n    (plugin) => !present(appDir, plugin.name),\n  )\n  const addedDependencies: string[] = []\n  for (const plugin of toCopy) {\n    copyPlugin(plugin, appDir)\n    addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies))\n    const tooling = mergeTooling(appDir, plugin)\n    appendGitignore(appDir, plugin.gitignore)\n    addedDependencies.push(...tooling.devDependencies)\n    if (tooling.scripts.length > 0)\n      io.stdout.write(\n        `new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(', ')}\\n`,\n      )\n  }\n  io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(', ')} to ${appDir}\\n`)\n  if (addedDependencies.length > 0)\n    io.stdout.write(`new dependencies: ${addedDependencies.join(', ')} (run npm install)\\n`)\n  for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) {\n    io.stdout.write(\n      `\\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\\n`,\n    )\n  }\n  return 0\n}\n\nconst PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/\n\n/**\n * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a\n * Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,\n * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.\n */\nfunction addExternal(folder: string, appDir: string, io: Io): number {\n  if (!existsSync(folder) || !statSync(folder).isDirectory()) {\n    io.stderr.write(`error: ${folder} is not a folder\\n`)\n    return 1\n  }\n  if (!['index.ts', 'index.js', 'index.mjs'].some((entry) => existsSync(join(folder, entry)))) {\n    io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\\n`)\n    return 1\n  }\n  const manifestFile = join(folder, 'package.json')\n  const manifest = existsSync(manifestFile)\n    ? (JSON.parse(readFileSync(manifestFile, 'utf8')) as {\n        name?: string\n        dependencies?: Record<string, string>\n      })\n    : {}\n  const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\\//, '')\n  if (!PLUGIN_NAME.test(name)) {\n    io.stderr.write(\n      `error: \"${name}\" is not a plugin name (lowercase letters, digits and dashes)\\n`,\n    )\n    return 1\n  }\n  const target = join(appDir, 'extensions', name)\n  if (existsSync(target)) {\n    io.stderr.write(`error: the app already has extensions/${name}\\n`)\n    return 1\n  }\n  cpSync(folder, target, {\n    recursive: true,\n    filter: (path) => !/[\\\\/](node_modules|\\.git)([\\\\/]|$)/.test(path.slice(folder.length)),\n  })\n  io.stdout.write(\n    `added external plugin ${name} to ${join(appDir, 'extensions')}; it installs at the next start\\n`,\n  )\n  const dependencies = Object.keys(manifest.dependencies ?? {})\n  if (dependencies.length > 0)\n    io.stdout.write(\n      `it uses ${dependencies.join(', ')}: add them to the app with npm install first\\n`,\n    )\n  return 0\n}\n\n/** `acrylblends plugins`: the library, one line per plugin. */\nexport function listPlugins(io: Io): number {\n  for (const plugin of readLibrary().values()) {\n    const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(', ')})` : ''\n    io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\\n`)\n  }\n  return 0\n}\n","import { existsSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { relative, resolve } from 'node:path'\nimport { UsageError } from './init'\nimport type { Io } from './io'\n\n/** Parse `build-client [root] [outDir]`. */\nexport function parseBuildClientOptions(argv: readonly string[]): { root: string; outDir: string } {\n  const args = argv.filter((a) => !a.startsWith('-'))\n  if (args.length !== argv.length)\n    throw new UsageError('build-client takes [root] [outDir] and no options')\n  if (args.length > 2)\n    throw new UsageError('build-client takes at most two arguments: [root] [outDir]')\n  return { root: args[0] ?? 'src/client', outDir: args[1] ?? 'dist/client' }\n}\n\n/**\n * Compile the app's client modules once (`buildClientModules` of the framework), for a production install that has no compiler at run time.\n * The framework is the one installed in the app (so the compiled files match the server that serves them), else this package's own.\n */\nexport async function buildClient(\n  options: { root: string; outDir: string },\n  io: Io,\n): Promise<number> {\n  const root = resolve(io.cwd, options.root)\n  if (!existsSync(root)) {\n    io.stderr.write(\n      `error: ${root} does not exist; the client modules live in src/client by default\\n`,\n    )\n    return 1\n  }\n  const outDir = resolve(io.cwd, options.outDir)\n  const here = createRequire(resolve(io.cwd, 'package.json'))\n  let specifier = 'acrylblends/node-server'\n  try {\n    here.resolve(specifier)\n  } catch {\n    specifier = new URL('../lib/node-server.js', import.meta.url).href\n  }\n  const mod = (await import(\n    specifier.startsWith('file:') ? specifier : here.resolve(specifier)\n  )) as typeof import('../lib/node-server')\n  const written = mod.buildClientModules({ root, outDir })\n  for (const file of written) io.stdout.write(`${relative(io.cwd, resolve(outDir, file))}\\n`)\n  io.stdout.write(`built ${written.length} files in ${relative(io.cwd, outDir) || '.'}\\n`)\n  return 0\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n  file: string\n  args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n  command: string,\n  args: readonly string[],\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n  exists: (path: string) => boolean = existsSync,\n  execPath: string = process.execPath,\n): Invocation {\n  if (platform !== 'win32') return { file: command, args: [...args] }\n  if (command === 'npm') {\n    const running = env.npm_execpath\n    const cli =\n      running !== undefined && /npm-cli\\.c?js$/.test(running)\n        ? running\n        : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n    if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n  }\n  return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport { createInterface } from 'node:readline/promises'\nimport { packageManagerInvocation } from './spawn'\n\n/** Everything the CLI touches outside the filesystem. Tests pass their own. */\nexport interface Io {\n  stdout: { write(text: string): unknown }\n  stderr: { write(text: string): unknown }\n  cwd: string\n  /** Ask one question; `undefined` when there is no terminal to ask on. */\n  ask: ((question: string) => Promise<string>) | undefined\n  /** Install dependencies in a directory; resolves to the exit code. */\n  install(directory: string): Promise<number>\n}\n\n/** The real terminal and `npm install`. */\nexport function processIo(): Io {\n  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n  return {\n    stdout: process.stdout,\n    stderr: process.stderr,\n    cwd: process.cwd(),\n    ask: interactive\n      ? async (question) => {\n          const rl = createInterface({ input: process.stdin, output: process.stdout })\n          try {\n            return await rl.question(question)\n          } finally {\n            rl.close()\n          }\n        }\n      : undefined,\n    install: (directory) =>\n      new Promise((done) => {\n        const { file, args } = packageManagerInvocation('npm', ['install'])\n        const child = spawn(file, args, { cwd: directory, stdio: 'inherit' })\n        child.on('error', () => done(1))\n        child.on('exit', (code) => done(code ?? 1))\n      }),\n  }\n}\n","import { createRequire } from 'node:module'\nimport { add, listPlugins, parseAddOptions } from './add'\nimport { buildClient, parseBuildClientOptions } from './build-client'\nimport { init, parseInitOptions, UsageError } from './init'\nimport { type Io, processIo } from './io'\n\n/** The version of this package. */\nexport const VERSION: string = (\n  createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `acrylblends ${VERSION} - scaffold Cordis apps\n\nUsage:\n  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory\n  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;\n                                      a folder path brings an external plugin into its extensions/\n  acrylblends plugins                    List the plugin library\n  acrylblends build-client [root] [out]  Compile the client modules once for production (src/client to dist/client)\n\nOptions for init:\n  --template <name>      blank or agent (asked when not given); --agent means --template agent,\n                         --no-agent means --template blank\n  --name <name>          the project name (default: the directory name)\n  --desktop              also add the desktop shell: npm run desktop opens a window on the app\n  --install              run npm install after copying\n  -y, --yes              ask nothing; use defaults (the blank template, no install)\n\n  -h, --help             show this help\n  -v, --version          show the version\n`\n\n/**\n * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.\n */\nexport async function runCli(argv: readonly string[], io: Io = processIo()): Promise<number> {\n  const [command, ...args] = argv\n  try {\n    if (command === undefined || command === 'help' || command === '-h' || command === '--help') {\n      io.stdout.write(HELP)\n      return command === undefined ? 2 : 0\n    }\n    if (command === 'version' || command === '-v' || command === '--version') {\n      io.stdout.write(`${VERSION}\\n`)\n      return 0\n    }\n    if (command === 'init') return await init(parseInitOptions(args), io)\n    if (command === 'add') return await add(parseAddOptions(args), io)\n    if (command === 'build-client') return await buildClient(parseBuildClientOptions(args), io)\n    if (command === 'plugins') return listPlugins(io)\n    throw new UsageError(`unknown command \"${command}\"`)\n  } catch (error) {\n    if (error instanceof UsageError) {\n      io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n      return 2\n    }\n    io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\\n`)\n    return 1\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["parse","parse"],"sources":["../src/library.ts","../src/project.ts","../src/templates.ts","../src/init.ts","../src/add.ts","../src/build-client.ts","../src/check-deps.ts","../src/spawn.ts","../src/io.ts","../src/kv-import.ts","../src/cli.ts"],"sourcesContent":["import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */\nexport interface LibraryPlugin {\n  readonly name: string\n  readonly description: string\n  /** Library plugins this one imports; they are copied with it. */\n  readonly requires: readonly string[]\n  /** npm packages an app needs at run time for this plugin. */\n  readonly dependencies: Readonly<Record<string, string>>\n  /** npm packages an app needs only to develop or run this plugin's tooling (for example `electron` for the desktop shell). */\n  readonly devDependencies?: Readonly<Record<string, string>>\n  /** `package.json` scripts the plugin adds; a script the app already has is kept. */\n  readonly scripts?: Readonly<Record<string, string>>\n  /** Lines the app's `.gitignore` needs for this plugin (added when missing, if the app has a `.gitignore`). */\n  readonly gitignore?: readonly string[]\n  /** How to mount it, shown after `acrylblends add`. */\n  readonly mount?: string\n  /**\n   * Paths inside the plugin folder that are not copied into an app (for example a React hook an app without React cannot type-check, or colocated test\n   * files). A pattern is an exact path or a glob: `*` matches within one folder name, `**` across folders, `?` one character; `**` followed by a slash also matches no folder.\n   */\n  readonly omit?: readonly string[]\n}\n\n/** A glob as a regular expression: `*` within a name, `**` across folders, `**` plus a slash may match no folder, `?` one character. */\nfunction globToRegExp(glob: string): RegExp {\n  let source = ''\n  for (let i = 0; i < glob.length; i += 1) {\n    const c = glob[i] as string\n    if (c === '*' && glob[i + 1] === '*') {\n      if (glob[i + 2] === '/') {\n        source += '(?:.*/)?'\n        i += 2\n      } else {\n        source += '.*'\n        i += 1\n      }\n    } else if (c === '*') source += '[^/]*'\n    else if (c === '?') source += '[^/]'\n    else source += c.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n  }\n  return new RegExp(`^${source}$`)\n}\n\n/** Whether a path inside a plugin folder (relative, any separator) is named by one of its `omit` patterns. */\nexport function isOmitted(inside: string, patterns: readonly string[] | undefined): boolean {\n  if (!patterns || patterns.length === 0) return false\n  const path = inside.split(sep).join('/')\n  return patterns.some((pattern) =>\n    /[*?]/.test(pattern) ? globToRegExp(pattern).test(path) : pattern === path,\n  )\n}\n\n/** Files of a library plugin that stay in the repository: its manifest and its tests. */\nconst LIBRARY_ONLY = new Set(['plugin.json', 'test', 'tests'])\n\nexport class LibraryError extends Error {\n  override name = 'LibraryError'\n}\n\n/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */\nexport function libraryRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'plugins')\n    if (existsSync(join(candidate, 'instance', 'plugin.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new LibraryError('acrylblends cannot find its plugin library (plugins/)')\n    dir = parent\n  }\n}\n\n/** Every plugin in the library, by name. */\nexport function readLibrary(root: string = libraryRoot()): Map<string, LibraryPlugin> {\n  const plugins = new Map<string, LibraryPlugin>()\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    const manifest = join(root, entry.name, 'plugin.json')\n    if (!entry.isDirectory() || !existsSync(manifest)) continue\n    const plugin = JSON.parse(readFileSync(manifest, 'utf8')) as LibraryPlugin\n    if (plugin.name !== entry.name)\n      throw new LibraryError(`plugins/${entry.name}/plugin.json names \"${plugin.name}\"`)\n    plugins.set(plugin.name, {\n      ...plugin,\n      requires: plugin.requires ?? [],\n      dependencies: plugin.dependencies ?? {},\n    })\n  }\n  return plugins\n}\n\n/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */\nexport function closure(\n  names: readonly string[],\n  library: Map<string, LibraryPlugin>,\n): LibraryPlugin[] {\n  const ordered: LibraryPlugin[] = []\n  const visiting = new Set<string>()\n  const visit = (name: string, trail: string[]) => {\n    if (ordered.some((plugin) => plugin.name === name)) return\n    const plugin = library.get(name)\n    if (!plugin)\n      throw new LibraryError(\n        `no plugin \"${name}\" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ''}`,\n      )\n    if (visiting.has(name))\n      throw new LibraryError(\n        `plugins require each other in a cycle: ${[...trail, name].join(' -> ')}`,\n      )\n    visiting.add(name)\n    for (const required of plugin.requires) visit(required, [...trail, name])\n    visiting.delete(name)\n    ordered.push(plugin)\n  }\n  for (const name of names) visit(name, [])\n  return ordered\n}\n\n/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */\nexport function copyPlugin(\n  plugin: LibraryPlugin,\n  appDir: string,\n  root: string = libraryRoot(),\n): string {\n  const target = join(appDir, 'src', 'plugins', plugin.name)\n  if (existsSync(target))\n    throw new LibraryError(\n      `src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`,\n    )\n  const source = join(root, plugin.name)\n  cpSync(source, target, {\n    recursive: true,\n    filter: (path) => {\n      const inside = path.slice(source.length + 1)\n      return (\n        !(dirname(path) === source && LIBRARY_ONLY.has(inside)) && !isOmitted(inside, plugin.omit)\n      )\n    },\n  })\n  return target\n}\n","import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs'\nimport { join } from 'node:path'\n\n/** Thrown when the target directory exists and is not empty. Nothing has been written. */\nexport class TargetNotEmptyError extends Error {\n  constructor(readonly target: string) {\n    super(\n      `refusing to write into \"${target}\": the directory is not empty. Choose an empty or new directory.`,\n    )\n    this.name = 'TargetNotEmptyError'\n  }\n}\n\n/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */\nexport function isValidName(name: string): boolean {\n  return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214\n}\n\n/** A valid default project name derived from a directory path. */\nexport function nameFrom(directory: string): string {\n  const base = directory.split(/[\\\\/]/).filter(Boolean).pop() ?? ''\n  const cleaned = base\n    .toLowerCase()\n    .replace(/[^a-z0-9-]+/g, '-')\n    .replace(/^[^a-z]+/, '')\n    .replace(/-+$/, '')\n  return cleaned || 'my-app'\n}\n\n/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */\nexport function assertTargetFree(target: string): void {\n  if (!existsSync(target)) return\n  if (!statSync(target).isDirectory() || readdirSync(target).length > 0)\n    throw new TargetNotEmptyError(target)\n}\n\n/**\n * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyTemplate(source: string, target: string, name: string): string[] {\n  assertTargetFree(target)\n  mkdirSync(target, { recursive: true })\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (\n        entry.name === 'node_modules' ||\n        (prefix === '' &&\n          (entry.name === TEMPLATE_MANIFEST ||\n            entry.name === 'upstream.json' ||\n            entry.name === 'AGENTS.md'))\n      )\n        continue\n      const sourcePath = join(from, entry.name)\n      // npm and git treat a file named .gitignore specially, so templates keep it as `gitignore` (and `dockerignore`).\n      const targetName =\n        prefix === '' && (entry.name === 'gitignore' || entry.name === 'dockerignore')\n          ? `.${entry.name}`\n          : entry.name\n      const targetPath = join(to, targetName)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      const text = readFileSync(sourcePath, 'utf8')\n      if (text.includes('__APP_NAME__'))\n        writeFileSync(targetPath, text.replaceAll('__APP_NAME__', name))\n      else cpSync(sourcePath, targetPath)\n      written.push(`${prefix}${targetName}`)\n    }\n  }\n  walk(source, target, '')\n  return written\n}\n\n/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied (nor is `upstream.json`, the record of what was synced from ACRYL, nor the template's `AGENTS.md`, which `writeAgentFiles` joins to the shared core). */\nexport const TEMPLATE_MANIFEST = 'template.json'\n\n/** The address a template's desktop window opens on, when it is not the root (`template.json`: `desktopPath`). */\nexport function readTemplateDesktopPath(templateDir: string): string | undefined {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return undefined\n  return (JSON.parse(readFileSync(file, 'utf8')) as { desktopPath?: string }).desktopPath\n}\n\n/** Record where the desktop window opens in package.json (`acrylblends.desktopPath`), read by `src/plugins/desktop/main.ts`. */\nexport function writeDesktopPath(appDir: string, path: string): void {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    acrylblends?: Record<string, unknown>\n  }\n  manifest.acrylblends = { ...manifest.acrylblends, desktopPath: path }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n}\n\nexport function readTemplatePlugins(templateDir: string): string[] {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return []\n  const { plugins } = JSON.parse(readFileSync(file, 'utf8')) as { plugins?: string[] }\n  return plugins ?? []\n}\n\n/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */\nexport function mergeDependencies(\n  appDir: string,\n  dependencies: Readonly<Record<string, string>>,\n): string[] {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    dependencies?: Record<string, string>\n  }\n  const current = manifest.dependencies ?? {}\n  const added = Object.keys(dependencies).filter((name) => !(name in current))\n  const merged = { ...dependencies, ...current }\n  manifest.dependencies = Object.fromEntries(\n    Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return added\n}\n\n/** Declare a file as an opener in package.json (`\"acryl\": { \"opener\": [...] }`): the one place that may import a database provider. */\nexport function mergeOpener(appDir: string, opener: string): void {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    acryl?: { opener?: string | string[] }\n  }\n  const current = manifest.acryl?.opener\n  const list = typeof current === 'string' ? [current] : (current ?? [])\n  if (list.includes(opener)) return\n  manifest.acryl = { ...manifest.acryl, opener: [...list, opener] }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n}\n\n/**\n * Add a plugin's development dependencies and scripts to an app's package.json: nothing the app already has is replaced. Returns the names of the development dependencies\n * and scripts added.\n */\nexport function mergeTooling(\n  appDir: string,\n  tooling: {\n    devDependencies?: Readonly<Record<string, string>> | undefined\n    scripts?: Readonly<Record<string, string>> | undefined\n  },\n): { devDependencies: string[]; scripts: string[] } {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    devDependencies?: Record<string, string>\n    scripts?: Record<string, string>\n  }\n  const dev = manifest.devDependencies ?? {}\n  const scripts = manifest.scripts ?? {}\n  const addedDev = Object.keys(tooling.devDependencies ?? {}).filter((name) => !(name in dev))\n  const addedScripts = Object.keys(tooling.scripts ?? {}).filter((name) => !(name in scripts))\n  manifest.devDependencies = Object.fromEntries(\n    Object.entries({ ...tooling.devDependencies, ...dev }).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  manifest.scripts = { ...tooling.scripts, ...scripts }\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return { devDependencies: addedDev, scripts: addedScripts }\n}\n\n/** Add the lines a plugin needs to the app's `.gitignore` when it has one and they are missing. Returns the lines added. */\nexport function appendGitignore(appDir: string, lines: readonly string[] | undefined): string[] {\n  const file = join(appDir, '.gitignore')\n  if (!lines || lines.length === 0 || !existsSync(file)) return []\n  const current = readFileSync(file, 'utf8')\n  const present = new Set(current.split('\\n').map((line) => line.trim()))\n  const missing = lines.filter((line) => !present.has(line))\n  if (missing.length > 0)\n    writeFileSync(\n      file,\n      `${current}${current.endsWith('\\n') || current === '' ? '' : '\\n'}${missing.join('\\n')}\\n`,\n    )\n  return missing\n}\n\n/** The generated app's guide for a coding agent: the shared core, then the template's own part. `CLAUDE.md` is only an import of it. */\nexport function writeAgentFiles(\n  sharedDir: string,\n  templateDir: string,\n  target: string,\n  name: string,\n): string[] {\n  const core = readFileSync(join(sharedDir, 'AGENTS.core.md'), 'utf8')\n  const own = existsSync(join(templateDir, 'AGENTS.md'))\n    ? readFileSync(join(templateDir, 'AGENTS.md'), 'utf8')\n    : ''\n  writeFileSync(join(target, 'AGENTS.md'), `${core}${own}`.replaceAll('__APP_NAME__', name))\n  writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\\n')\n  return ['AGENTS.md', 'CLAUDE.md']\n}\n\n/**\n * Copy the framework's docs (a generated copy of ACRYL's `docs/framework`, already checked against its digest) into `<app>/docs/framework/`,\n * so a coding agent working in the app reads the API from the folder it is in. The generated-copy notes and the digest record stay behind.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyFrameworkDocs(source: string, target: string): string[] {\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (entry.name === 'upstream.json' || entry.name === 'UPSTREAM.md') continue\n      const sourcePath = join(from, entry.name)\n      const targetPath = join(to, entry.name)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      cpSync(sourcePath, targetPath)\n      written.push(`docs/framework/${prefix}${entry.name}`)\n    }\n  }\n  mkdirSync(join(target, 'docs', 'framework'), { recursive: true })\n  walk(source, join(target, 'docs', 'framework'), '')\n  return written\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** 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. */\nexport const TEMPLATES = ['blank', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\n\nexport function isTemplate(value: string): value is Template {\n  return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/**\n * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build\n * (`dist/`), so walk up until a `templates` folder holds the `blank` template.\n */\nexport function templatesRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'templates')\n    if (existsSync(join(candidate, 'blank'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) throw new Error('acrylblends cannot find its templates folder')\n    dir = parent\n  }\n}\n\n/** Absolute path of a template folder. */\nexport function templateDir(template: Template): string {\n  return join(templatesRoot(), template)\n}\n\n/** The text every generated app's `AGENTS.md` starts with (`shared/`, beside `templates/`). */\nexport function sharedDir(): string {\n  return join(dirname(templatesRoot()), 'shared')\n}\n\n/**\n * The framework's docs, as ACRYL wrote them: `docs/framework` of the repository, or the copy `prepack` puts inside the package. The module sits at\n * different depths in source and in the build, so walk up until a `docs/framework` folder holds the README.\n */\nexport function frameworkDocsRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'docs', 'framework')\n    if (existsSync(join(candidate, 'README.md'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new Error('acrylblends cannot find the framework docs (docs/framework)')\n    dir = parent\n  }\n}\n","import { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport type { Io } from './io'\nimport { closure, copyPlugin, readLibrary } from './library'\nimport {\n  copyFrameworkDocs,\n  copyTemplate,\n  isValidName,\n  mergeDependencies,\n  mergeTooling,\n  nameFrom,\n  readTemplateDesktopPath,\n  readTemplatePlugins,\n  TargetNotEmptyError,\n  writeAgentFiles,\n  writeDesktopPath,\n} from './project'\nimport {\n  frameworkDocsRoot,\n  isTemplate,\n  sharedDir,\n  TEMPLATES,\n  type Template,\n  templateDir,\n} from './templates'\n\n/** A command line mistake. The CLI prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n  override name = 'UsageError'\n}\n\n/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */\nexport interface InitOptions {\n  directory: string | undefined\n  name: string | undefined\n  template: Template | undefined\n  install: boolean | undefined\n  /** Also add the desktop shell (`add desktop`): an Electron window on the app's own server. */\n  desktop: boolean\n  yes: boolean\n}\n\n/** Parse `init [dir] [--template t] [--agent|--no-agent] [--name n] [--install] [-y]`. `--agent` means `--template agent`, `--no-agent` means `--template blank`. */\nexport function parseInitOptions(argv: readonly string[]): InitOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const { values, positionals } = parsed\n  if (positionals.length > 1) throw new UsageError('init takes at most one directory')\n  if (values.agent && values['no-agent'])\n    throw new UsageError('use --agent or --no-agent, not both')\n  if (values.template !== undefined && !isTemplate(values.template))\n    throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n  const alias: Template | undefined = values.agent\n    ? 'agent'\n    : values['no-agent']\n      ? 'blank'\n      : undefined\n  if (values.template !== undefined && alias !== undefined && values.template !== alias)\n    throw new UsageError(\n      `--template ${values.template} contradicts --${alias === 'agent' ? 'agent' : 'no-agent'}`,\n    )\n  return {\n    directory: positionals[0],\n    name: values.name,\n    template: (values.template as Template | undefined) ?? alias,\n    install: values.install,\n    desktop: values.desktop === true,\n    yes: values.yes === true,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      name: { type: 'string' },\n      template: { type: 'string' },\n      agent: { type: 'boolean' },\n      'no-agent': { type: 'boolean' },\n      install: { type: 'boolean' },\n      desktop: { type: 'boolean' },\n      yes: { type: 'boolean', short: 'y' },\n    },\n  })\n\nconst yes = (answer: string) => ['y', 'yes'].includes(answer.trim().toLowerCase())\n\nasync function askTemplate(ask: (question: string) => Promise<string>): Promise<Template> {\n  const answer = (await ask(`Template (${TEMPLATES.join(', ')}) [blank]: `)).trim().toLowerCase()\n  if (answer === '') return 'blank'\n  if (isTemplate(answer)) return answer\n  throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n}\n\n/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */\nexport async function init(options: InitOptions, io: Io): Promise<number> {\n  const relative = options.directory ?? '.'\n  const directory = resolve(io.cwd, relative)\n  const ask = options.yes ? undefined : io.ask\n\n  let name = options.name ?? nameFrom(directory)\n  if (options.name === undefined && ask)\n    name = (await ask(`Project name (${name}): `)).trim() || name\n  if (!isValidName(name)) {\n    throw new UsageError(\n      `\"${name}\" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`,\n    )\n  }\n  const template = options.template ?? (ask ? await askTemplate(ask) : 'blank')\n  const install =\n    options.install ?? (ask ? yes(await ask('Install dependencies with npm now? (y/N): ')) : false)\n\n  let files: string[]\n  try {\n    files = copyTemplate(templateDir(template), directory, name)\n    files.push(...writeAgentFiles(sharedDir(), templateDir(template), directory, name))\n    files.push(...copyFrameworkDocs(frameworkDocsRoot(), directory))\n  } catch (error) {\n    if (!(error instanceof TargetNotEmptyError)) throw error\n    io.stderr.write(`error: ${error.message}\\n`)\n    return 1\n  }\n  const plugins = closure(\n    [...readTemplatePlugins(templateDir(template)), ...(options.desktop ? ['desktop'] : [])],\n    readLibrary(),\n  )\n  for (const plugin of plugins) {\n    copyPlugin(plugin, directory)\n    mergeDependencies(directory, plugin.dependencies)\n    mergeTooling(directory, plugin)\n  }\n  const desktopPath = options.desktop ? readTemplateDesktopPath(templateDir(template)) : undefined\n  if (desktopPath !== undefined) writeDesktopPath(directory, desktopPath)\n  io.stdout.write(\n    `created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(', ')}\\n`,\n  )\n\n  if (install && (await io.install(directory)) !== 0) {\n    io.stderr.write('error: npm install failed; run it yourself in the new directory\\n')\n    return 1\n  }\n  const steps = [\n    relative === '.' ? '' : `  cd ${relative}\\n`,\n    install ? '' : '  npm install\\n',\n    '  npm run dev\\n  npm test\\n',\n  ]\n  io.stdout.write(`\\nNext:\\n${steps.join('')}`)\n  return 0\n}\n","import { cpSync, existsSync, readFileSync, statSync } from 'node:fs'\nimport { basename, join, resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\nimport { closure, copyPlugin, type LibraryPlugin, readLibrary } from './library'\nimport { appendGitignore, mergeDependencies, mergeOpener, mergeTooling } from './project'\n\nexport interface AddOptions {\n  readonly names: readonly string[]\n  readonly directory: string | undefined\n}\n\n/** Parse `add <plugin...> [--dir <app>]`. */\nexport function parseAddOptions(argv: readonly string[]): AddOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  if (parsed.positionals.length === 0)\n    throw new UsageError('add needs at least one plugin name (see \"acrylblends plugins\")')\n  return { names: parsed.positionals, directory: parsed.values.dir }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: { dir: { type: 'string' } },\n  })\n\nconst present = (appDir: string, name: string) => existsSync(join(appDir, 'src', 'plugins', name))\n\n/**\n * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.\n * Refuses a plugin the app already has. Returns the exit code.\n */\nexport async function add(options: AddOptions, io: Io): Promise<number> {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  if (!existsSync(join(appDir, 'package.json')) || !existsSync(join(appDir, 'src'))) {\n    io.stderr.write(\n      `error: ${appDir} is not an app (no package.json and src/); run \"acrylblends init\" first\\n`,\n    )\n    return 1\n  }\n  // A path is an external plugin folder; anything else is a library plugin name.\n  const external = options.names.filter((name) => /[\\\\/]/.test(name) || name.startsWith('.'))\n  for (const folder of external) {\n    const code = addExternal(resolve(io.cwd, folder), appDir, io)\n    if (code !== 0) return code\n  }\n  // The desktop shell has two forms: the Blend app (it needs the `instance` plugin) and a plain Acryl app (`export default app`); `desktop` means the one that fits.\n  const plain = !existsSync(join(appDir, 'src', 'plugins', 'instance'))\n  if (plain && options.names.includes('db')) {\n    io.stderr.write(\n      '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',\n    )\n    return 1\n  }\n  if (plain && options.names.includes('kv')) {\n    io.stderr.write(\n      'error: \"kv\" is the Cordis plugin for a Blend app. A plain Acryl app opens its store with openKv from \"acrylblends/kv/json\" (see docs/framework/guides/data.md#a-tiny-app-kv)\\n',\n    )\n    return 1\n  }\n  const names = options.names\n    .filter((name) => !external.includes(name))\n    // `db` is the SQLite provider of the db port (it brings the port); a plain app opens its database with `acrylblends/db/sqlite` instead.\n    .map((name) => (name === 'db' ? 'acryl-db-sqlite' : name))\n    // `kv` is the JSON-file provider of the kv port (it brings the port); `acryl-kv-db` is the one over db.\n    .map((name) => (name === 'kv' ? 'acryl-kv-json' : name))\n    .map((name) => (name === 'desktop' && plain ? 'desktop-web' : name))\n  if (names.length === 0) return 0\n  const already = names.filter((name) => present(appDir, name))\n  if (already.length > 0) {\n    io.stderr.write(\n      `error: the app already has ${already.map((name) => `src/plugins/${name}`).join(', ')}\\n`,\n    )\n    return 1\n  }\n  const toCopy: LibraryPlugin[] = closure(names, readLibrary()).filter(\n    (plugin) => !present(appDir, plugin.name),\n  )\n  const addedDependencies: string[] = []\n  for (const plugin of toCopy) {\n    copyPlugin(plugin, appDir)\n    addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies))\n    const tooling = mergeTooling(appDir, plugin)\n    appendGitignore(appDir, plugin.gitignore)\n    // The provider is mounted from src/app.ts, which is therefore the one file that may import it (`acrylblends check-deps`).\n    if (plugin.name === 'acryl-db-sqlite') mergeOpener(appDir, 'src/app.ts')\n    addedDependencies.push(...tooling.devDependencies)\n    if (tooling.scripts.length > 0)\n      io.stdout.write(\n        `new scripts: ${tooling.scripts.map((name) => `npm run ${name}`).join(', ')}\\n`,\n      )\n  }\n  io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(', ')} to ${appDir}\\n`)\n  if (addedDependencies.length > 0)\n    io.stdout.write(`new dependencies: ${addedDependencies.join(', ')} (run npm install)\\n`)\n  for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) {\n    io.stdout.write(\n      `\\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\\n`,\n    )\n  }\n  return 0\n}\n\nconst PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/\n\n/**\n * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a\n * Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,\n * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.\n */\nfunction addExternal(folder: string, appDir: string, io: Io): number {\n  if (!existsSync(folder) || !statSync(folder).isDirectory()) {\n    io.stderr.write(`error: ${folder} is not a folder\\n`)\n    return 1\n  }\n  if (!['index.ts', 'index.js', 'index.mjs'].some((entry) => existsSync(join(folder, entry)))) {\n    io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\\n`)\n    return 1\n  }\n  const manifestFile = join(folder, 'package.json')\n  const manifest = existsSync(manifestFile)\n    ? (JSON.parse(readFileSync(manifestFile, 'utf8')) as {\n        name?: string\n        dependencies?: Record<string, string>\n      })\n    : {}\n  const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\\//, '')\n  if (!PLUGIN_NAME.test(name)) {\n    io.stderr.write(\n      `error: \"${name}\" is not a plugin name (lowercase letters, digits and dashes)\\n`,\n    )\n    return 1\n  }\n  const target = join(appDir, 'extensions', name)\n  if (existsSync(target)) {\n    io.stderr.write(`error: the app already has extensions/${name}\\n`)\n    return 1\n  }\n  cpSync(folder, target, {\n    recursive: true,\n    filter: (path) => !/[\\\\/](node_modules|\\.git)([\\\\/]|$)/.test(path.slice(folder.length)),\n  })\n  io.stdout.write(\n    `added external plugin ${name} to ${join(appDir, 'extensions')}; it installs at the next start\\n`,\n  )\n  const dependencies = Object.keys(manifest.dependencies ?? {})\n  if (dependencies.length > 0)\n    io.stdout.write(\n      `it uses ${dependencies.join(', ')}: add them to the app with npm install first\\n`,\n    )\n  return 0\n}\n\n/** `acrylblends plugins`: the library, one line per plugin. */\nexport function listPlugins(io: Io): number {\n  for (const plugin of readLibrary().values()) {\n    const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(', ')})` : ''\n    io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\\n`)\n  }\n  return 0\n}\n","import { existsSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { relative, resolve } from 'node:path'\nimport { UsageError } from './init'\nimport type { Io } from './io'\n\n/** Parse `build-client [root] [outDir]`. */\nexport function parseBuildClientOptions(argv: readonly string[]): { root: string; outDir: string } {\n  const args = argv.filter((a) => !a.startsWith('-'))\n  if (args.length !== argv.length)\n    throw new UsageError('build-client takes [root] [outDir] and no options')\n  if (args.length > 2)\n    throw new UsageError('build-client takes at most two arguments: [root] [outDir]')\n  return { root: args[0] ?? 'src/client', outDir: args[1] ?? 'dist/client' }\n}\n\n/**\n * Compile the app's client modules once (`buildClientModules` of the framework), for a production install that has no compiler at run time.\n * The framework is the one installed in the app (so the compiled files match the server that serves them), else this package's own.\n */\nexport async function buildClient(\n  options: { root: string; outDir: string },\n  io: Io,\n): Promise<number> {\n  const root = resolve(io.cwd, options.root)\n  if (!existsSync(root)) {\n    io.stderr.write(\n      `error: ${root} does not exist; the client modules live in src/client by default\\n`,\n    )\n    return 1\n  }\n  const outDir = resolve(io.cwd, options.outDir)\n  const here = createRequire(resolve(io.cwd, 'package.json'))\n  let specifier = 'acrylblends/node-server'\n  try {\n    here.resolve(specifier)\n  } catch {\n    specifier = new URL('../lib/node-server.js', import.meta.url).href\n  }\n  const mod = (await import(\n    specifier.startsWith('file:') ? specifier : here.resolve(specifier)\n  )) as typeof import('../lib/node-server')\n  const written = mod.buildClientModules({ root, outDir })\n  for (const file of written) io.stdout.write(`${relative(io.cwd, resolve(outDir, file))}\\n`)\n  io.stdout.write(`built ${written.length} files in ${relative(io.cwd, outDir) || '.'}\\n`)\n  return 0\n}\n","import { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { join, relative, resolve, sep } from 'node:path'\nimport type { Io } from './io'\n\n/**\n * The dependency rule (spec 049): app code imports a port, never a provider. A port is `acrylblends/db` (the `Db` type); a provider is a\n * driver or the one function that opens a database. Only the opener, a file the app names once in package.json, may import a provider.\n */\n\n/** A package that is a database driver. An import of it, or of anything below it, is a provider import. */\nconst DRIVERS = [\n  'node:sqlite',\n  'sqlite',\n  'sqlite3',\n  'better-sqlite3',\n  '@libsql/client',\n  'libsql',\n  'pg',\n  'pg-pool',\n  'pg-native',\n  'postgres',\n  '@electric-sql/pglite',\n  '@neondatabase/serverless',\n  '@vercel/postgres',\n  'mysql',\n  'mysql2',\n]\n/** The openers a provider ships: importing one of them is opening a database. */\nconst OPENERS = ['acrylblends/db/sqlite', 'acryl-db-sqlite']\n/** The desktop shell is where Electron lives (`acrylblends add desktop` copies it). */\nconst ELECTRON = 'electron'\nconst ELECTRON_HOMES = ['src/plugins/desktop/', 'src/plugins/desktop-web/']\n/** The provider plugins themselves may import what they wrap. */\nconst PROVIDER_HOMES = ['src/plugins/acryl-db-sqlite/']\n\nconst SOURCE = /\\.(?:[cm]?[jt]s|[jt]sx)$/u\nconst SKIP_DIRS = new Set(['node_modules', 'dist', 'lib', 'build', 'coverage'])\nconst ROOTS = ['src', 'test', 'tests', 'extensions']\n\nexport interface Violation {\n  readonly file: string\n  readonly line: number\n  readonly specifier: string\n  readonly kind: 'driver' | 'opener' | 'electron'\n}\n\nconst matches = (specifier: string, name: string): boolean =>\n  specifier === name || specifier.startsWith(`${name}/`)\n\n/** What a specifier is to the rule, or undefined when it is not a provider. */\nexport function classifySpecifier(specifier: string): Violation['kind'] | undefined {\n  if (DRIVERS.some((name) => matches(specifier, name))) return 'driver'\n  if (OPENERS.some((name) => matches(specifier, name))) return 'opener'\n  if (matches(specifier, ELECTRON)) return 'electron'\n  return undefined\n}\n\n/** The source with every comment replaced by spaces (newlines kept), so a line number still means what it did and a commented import is not an import. */\nexport function blankComments(source: string): string {\n  let out = ''\n  let i = 0\n  while (i < source.length) {\n    const c = source[i] as string\n    const next = source[i + 1]\n    if (c === '/' && next === '/') {\n      const end = source.indexOf('\\n', i)\n      const stop = end === -1 ? source.length : end\n      out += ' '.repeat(stop - i)\n      i = stop\n    } else if (c === '/' && next === '*') {\n      const end = source.indexOf('*/', i + 2)\n      const stop = end === -1 ? source.length : end + 2\n      out += source.slice(i, stop).replace(/[^\\n]/gu, ' ')\n      i = stop\n    } else if (c === \"'\" || c === '\"' || c === '`') {\n      let j = i + 1\n      while (j < source.length && source[j] !== c) {\n        if (source[j] === '\\\\') j += 1\n        else if (c !== '`' && source[j] === '\\n') break\n        j += 1\n      }\n      out += source.slice(i, Math.min(j + 1, source.length))\n      i = j + 1\n    } else {\n      out += c\n      i += 1\n    }\n  }\n  return out\n}\n\n/** `import x from 'a'`, `export * from 'a'`, `import 'a'`, `import('a')` and `require('a')`, with the line of each. */\nconst IMPORT =\n  /(?:^|[\\s;{}()])(?:import\\s*(?:type\\s+)?(?:[\\w*${},\\s]*?\\s*from\\s*)?|export\\s*(?:type\\s+)?[\\w*${},\\s]*?\\s*from\\s*|import\\s*\\(\\s*|require\\s*\\(\\s*)(['\"])([^'\"\\n]+)\\1/gu\n\nexport function importsOf(source: string): { specifier: string; line: number }[] {\n  const code = blankComments(source)\n  const found: { specifier: string; line: number }[] = []\n  for (const match of code.matchAll(IMPORT)) {\n    const specifier = match[2] as string\n    const at = (match.index ?? 0) + match[0].length - specifier.length - 2\n    found.push({ specifier, line: code.slice(0, at).split('\\n').length })\n  }\n  return found\n}\n\nfunction listSources(dir: string, out: string[] = []): string[] {\n  if (!existsSync(dir)) return out\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    if (entry.name.startsWith('.') || SKIP_DIRS.has(entry.name)) continue\n    const path = join(dir, entry.name)\n    if (entry.isDirectory()) listSources(path, out)\n    else if (SOURCE.test(entry.name) && !entry.name.endsWith('.d.ts')) out.push(path)\n  }\n  return out\n}\n\n/** The opener files the app declares: `\"acryl\": { \"opener\": \"src/db.ts\" }` (or a list) in package.json. */\nexport function openersOf(appDir: string): string[] {\n  const file = join(appDir, 'package.json')\n  if (!existsSync(file)) return []\n  const declared = (JSON.parse(readFileSync(file, 'utf8')) as { acryl?: { opener?: unknown } })\n    .acryl?.opener\n  const list = typeof declared === 'string' ? [declared] : Array.isArray(declared) ? declared : []\n  return list.filter((entry): entry is string => typeof entry === 'string')\n}\n\n/** Every provider import outside the declared opener (and the homes that may hold one), in file and line order. */\nexport function findViolations(appDir: string): Violation[] {\n  const openers = new Set(openersOf(appDir).map((entry) => entry.split(sep).join('/')))\n  const violations: Violation[] = []\n  for (const root of ROOTS) {\n    for (const path of listSources(join(appDir, root)).sort()) {\n      const file = relative(appDir, path).split(sep).join('/')\n      if (openers.has(file)) continue\n      for (const { specifier, line } of importsOf(readFileSync(path, 'utf8'))) {\n        const kind = classifySpecifier(specifier)\n        if (kind === undefined) continue\n        if (kind === 'electron' && ELECTRON_HOMES.some((home) => file.startsWith(home))) continue\n        if (kind !== 'electron' && PROVIDER_HOMES.some((home) => file.startsWith(home))) continue\n        violations.push({ file, line, specifier, kind })\n      }\n    }\n  }\n  return violations\n}\n\nconst GUIDE = 'docs/framework/guides/data.md#why-the-database-is-opened-in-one-place'\n\nfunction advice(violation: Violation, openers: readonly string[]): string {\n  if (violation.kind === 'electron')\n    return `\"${violation.specifier}\" is the desktop shell's: only src/plugins/desktop (added with \"acrylblends add desktop\") imports electron`\n  const where =\n    openers.length > 0\n      ? openers.join(', ')\n      : 'a file named in package.json \"acryl\": { \"opener\": \"...\" }'\n  return violation.kind === 'driver'\n    ? `\"${violation.specifier}\" is a database driver; take a Db (import type { Db } from \"acrylblends/db\") as an argument and let ${where} open the database`\n    : `\"${violation.specifier}\" opens a database, and only ${where} may; take a Db (import type { Db } from \"acrylblends/db\") as an argument`\n}\n\n/** Parse `check-deps [dir]`. */\nexport function parseCheckDepsOptions(argv: readonly string[]): { directory: string | undefined } {\n  const args = argv.filter((a) => !a.startsWith('-'))\n  if (args.length !== argv.length || args.length > 1)\n    throw new Error('check-deps takes at most one argument: the app folder')\n  return { directory: args[0] }\n}\n\n/** Report each provider import outside the opener, as `file:line: why`. Returns the exit code: 1 when there is one. */\nexport function checkDeps(options: { directory: string | undefined }, io: Io): number {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  const violations = findViolations(appDir)\n  if (violations.length === 0) {\n    io.stdout.write('check-deps: no app code imports a database provider outside the opener\\n')\n    return 0\n  }\n  const openers = openersOf(appDir)\n  for (const violation of violations)\n    io.stderr.write(`${violation.file}:${violation.line}: ${advice(violation, openers)}\\n`)\n  io.stderr.write(`See ${GUIDE}\\n`)\n  return 1\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n  file: string\n  args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n  command: string,\n  args: readonly string[],\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n  exists: (path: string) => boolean = existsSync,\n  execPath: string = process.execPath,\n): Invocation {\n  if (platform !== 'win32') return { file: command, args: [...args] }\n  if (command === 'npm') {\n    const running = env.npm_execpath\n    const cli =\n      running !== undefined && /npm-cli\\.c?js$/.test(running)\n        ? running\n        : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n    if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n  }\n  return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport { createInterface } from 'node:readline/promises'\nimport { packageManagerInvocation } from './spawn'\n\n/** Everything the CLI touches outside the filesystem. Tests pass their own. */\nexport interface Io {\n  stdout: { write(text: string): unknown }\n  stderr: { write(text: string): unknown }\n  cwd: string\n  /** Ask one question; `undefined` when there is no terminal to ask on. */\n  ask: ((question: string) => Promise<string>) | undefined\n  /** Install dependencies in a directory; resolves to the exit code. */\n  install(directory: string): Promise<number>\n}\n\n/** The real terminal and `npm install`. */\nexport function processIo(): Io {\n  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n  return {\n    stdout: process.stdout,\n    stderr: process.stderr,\n    cwd: process.cwd(),\n    ask: interactive\n      ? async (question) => {\n          const rl = createInterface({ input: process.stdin, output: process.stdout })\n          try {\n            return await rl.question(question)\n          } finally {\n            rl.close()\n          }\n        }\n      : undefined,\n    install: (directory) =>\n      new Promise((done) => {\n        const { file, args } = packageManagerInvocation('npm', ['install'])\n        const child = spawn(file, args, { cwd: directory, stdio: 'inherit' })\n        child.on('error', () => done(1))\n        child.on('exit', (code) => done(code ?? 1))\n      }),\n  }\n}\n","import { existsSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\n\nexport interface KvImportOptions {\n  readonly from: string\n  readonly to: string\n  readonly overwrite: boolean\n  readonly table: string | undefined\n  readonly migrations: string | undefined\n}\n\n/** Parse `kv import <kv.json> <database.sqlite> [--overwrite] [--table name] [--migrations dir]`. */\nexport function parseKvOptions(argv: readonly string[]): KvImportOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const [action, from, to, ...rest] = parsed.positionals\n  if (action !== 'import')\n    throw new UsageError('kv takes one subcommand: kv import <kv.json> <database.sqlite>')\n  if (from === undefined || to === undefined || rest.length > 0)\n    throw new UsageError('kv import takes two arguments: the JSON file and the SQLite file')\n  return {\n    from,\n    to,\n    overwrite: parsed.values.overwrite ?? false,\n    table: parsed.values.table,\n    migrations: parsed.values.migrations,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      overwrite: { type: 'boolean' },\n      table: { type: 'string' },\n      migrations: { type: 'string' },\n    },\n  })\n\n/** The framework as the app has it installed (so the code that reads the file is the code the app runs), else this package's own. */\nasync function framework<T>(io: Io, subpath: string, own: string): Promise<T> {\n  const here = createRequire(resolve(io.cwd, 'package.json'))\n  try {\n    return (await import(here.resolve(`acrylblends/${subpath}`))) as T\n  } catch {\n    return (await import(new URL(`../lib/${own}`, import.meta.url).href)) as T\n  }\n}\n\n/**\n * Import a JSON-file kv store into the `kv` table of an app's SQLite database: the move from `acryl-kv-json` to SQL. The file is not changed.\n * The database is opened with the app's `migrations/` folder when it has one (a database whose schema is newer than the files given is refused),\n * and the table is created when missing. Refuses to overwrite a key the table already has unless `--overwrite`.\n */\nexport async function kvImport(options: KvImportOptions, io: Io): Promise<number> {\n  const from = resolve(io.cwd, options.from)\n  const to = resolve(io.cwd, options.to)\n  if (!existsSync(from)) {\n    io.stderr.write(`error: ${from} does not exist\\n`)\n    return 1\n  }\n  const kvCore = await framework<typeof import('../lib/kv')>(io, 'kv', 'kv.js')\n  const json = await framework<typeof import('../lib/kv/json')>(io, 'kv/json', 'kv/json.js')\n  const onDb = await framework<typeof import('../lib/kv/db')>(io, 'kv/db', 'kv/db.js')\n  const sqlite = await framework<typeof import('../lib/db/sqlite')>(io, 'db/sqlite', 'db/sqlite.js')\n  const migrations =\n    options.migrations !== undefined\n      ? resolve(io.cwd, options.migrations)\n      : existsSync(resolve(io.cwd, 'migrations'))\n        ? resolve(io.cwd, 'migrations')\n        : undefined\n  const source = await json.openKv({ path: from })\n  try {\n    const database = await sqlite.openDb({\n      path: to,\n      ...(migrations === undefined ? {} : { migrations }),\n    })\n    try {\n      const target = onDb.kvOnDb(\n        database.db,\n        options.table === undefined ? {} : { table: options.table },\n      )\n      const result = await kvCore.copyKv(source.kv, target, { overwrite: options.overwrite })\n      io.stdout.write(\n        `imported ${result.copied} ${result.copied === 1 ? 'key' : 'keys'} from ${options.from} into ${options.to}` +\n          `${options.table === undefined ? '' : ` (table ${options.table})`}` +\n          `${result.overwritten > 0 ? `, ${result.overwritten} overwritten` : ''}\\n`,\n      )\n      return 0\n    } finally {\n      await database.close()\n    }\n  } finally {\n    await source.close()\n  }\n}\n","import { createRequire } from 'node:module'\nimport { add, listPlugins, parseAddOptions } from './add'\nimport { buildClient, parseBuildClientOptions } from './build-client'\nimport { checkDeps, parseCheckDepsOptions } from './check-deps'\nimport { init, parseInitOptions, UsageError } from './init'\nimport { type Io, processIo } from './io'\nimport { kvImport, parseKvOptions } from './kv-import'\n\n/** The version of this package. */\nexport const VERSION: string = (\n  createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `acrylblends ${VERSION} - scaffold Cordis apps\n\nUsage:\n  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory\n  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;\n                                      a folder path brings an external plugin into its extensions/\n  acrylblends plugins                    List the plugin library\n  acrylblends build-client [root] [out]  Compile the client modules once for production (src/client to dist/client)\n  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]\n  acrylblends check-deps [dir]           Fail when app code imports a database driver or opener outside the file named in\n                                      package.json \"acryl\": { \"opener\": \"src/db.ts\" } (a port is imported, a provider is not)\n\nOptions for init:\n  --template <name>      blank or agent (asked when not given); --agent means --template agent,\n                         --no-agent means --template blank\n  --name <name>          the project name (default: the directory name)\n  --desktop              also add the desktop shell: npm run desktop opens a window on the app\n  --install              run npm install after copying\n  -y, --yes              ask nothing; use defaults (the blank template, no install)\n\n  -h, --help             show this help\n  -v, --version          show the version\n`\n\n/**\n * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.\n */\nexport async function runCli(argv: readonly string[], io: Io = processIo()): Promise<number> {\n  const [command, ...args] = argv\n  try {\n    if (command === undefined || command === 'help' || command === '-h' || command === '--help') {\n      io.stdout.write(HELP)\n      return command === undefined ? 2 : 0\n    }\n    if (command === 'version' || command === '-v' || command === '--version') {\n      io.stdout.write(`${VERSION}\\n`)\n      return 0\n    }\n    if (command === 'init') return await init(parseInitOptions(args), io)\n    if (command === 'add') return await add(parseAddOptions(args), io)\n    if (command === 'build-client') return await buildClient(parseBuildClientOptions(args), io)\n    if (command === 'kv') return await kvImport(parseKv(args), io)\n    if (command === 'check-deps') return checkDeps(parseCheckDeps(args), io)\n    if (command === 'plugins') return listPlugins(io)\n    throw new UsageError(`unknown command \"${command}\"`)\n  } catch (error) {\n    if (error instanceof UsageError) {\n      io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n      return 2\n    }\n    io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\\n`)\n    return 1\n  }\n}\n\nfunction parseCheckDeps(args: readonly string[]) {\n  try {\n    return parseCheckDepsOptions(args)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n}\n\nfunction parseKv(args: readonly string[]) {\n  return parseKvOptions(args)\n}\n"],"mappings":"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"}

package/docs/framework/UPSTREAM.md

@@ -1,3 +1,3 @@
 # Generated copy
 
-This folder is a copy of `docs/framework` of acryldev/acryl at commit `4721bb00960fa4e157e6070c330cf87c148739fc`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.
+This folder is a copy of `docs/framework` of acryldev/acryl at commit `f8e385e4389fe2fdc6fd2a4366a7f2a7389faacb`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.

package/docs/framework/guides/data.md

@@ -10,10 +10,74 @@ provider today; a Postgres provider (Postgres or Supabase through `DATABASE_URL`
 | --- | --- | --- |
 | Normal web or desktop app, users, lists, orders | `db` with SQLite (the `notes` and `chat` templates) | available |
 | Hosted, many users | `db` with Postgres or Supabase | planned |
-| Tiny, one person, a few screens | `kv`, named JSON documents with no SQL | planned |
+| Tiny, one person, a few screens | [`kv`](#a-tiny-app-kv), named JSON documents with no SQL | available |
 | Agents or long tasks that must survive a restart | `durable`, in the same database as `db` | planned |
 
-Start with `db`. It is the only one of the four you can use today, and SQL is what people and coding agents already know.
+Start with `db` when the data has users, lists or relations: SQL is what people and coding agents already know. Start with `kv` when the whole
+data is a handful of settings or a small list that one process reads and writes.
+
+## A tiny app: `kv`
+
+`kv` keeps named JSON documents in one file, with no SQL and no migrations. It suits a settings page, a demo, a one-person tool.
+
+```ts
+import { openKv } from 'acrylblends/kv/json'
+
+const { kv, close } = await openKv({ path: 'data/kv.json' })
+
+await kv.set('theme', 'dark')
+const theme = await kv.get<string>('theme') // 'dark'; undefined for a key that was never set
+
+// Change a value from the value it has now, without losing a concurrent change.
+const visits = await kv.update<number>('visits', (current) => (current ?? 0) + 1)
+
+await kv.set('todos/1', { title: 'Buy milk', done: false })
+await kv.set('todos/2', { title: 'Write docs', done: true })
+const keys = await kv.list('todos/') // ['todos/1', 'todos/2'], sorted by code point
+
+await kv.delete('todos/1') // a key that is not there is not an error
+await close()
+```
+
+- A key is a non-empty string; a prefix such as `todos/` groups related documents. A value is JSON (`null`, booleans, numbers, strings, arrays,
+  objects). `undefined`, functions, bigints and `NaN` are refused with a `TypeError` before anything is written, and a value read back is a copy.
+- `update` runs your function with the current value (`undefined` when the key is missing) and stores what it returns. The function is
+  **synchronous**: an `async` function is a type error. Read what you need first with `await kv.get(...)`, then update with a plain function.
+  If it throws, the value stays as it was.
+- Every write reaches the disk before its promise resolves, and the file is replaced as a whole (a temporary file, then a rename), so a crash
+  or a power cut leaves the old file or the new one, never half of one. A file that exists but does not parse stops the app with a message that
+  names it; it is never started over.
+- Like `db`, the store is passed to the code that needs it (`createApp(kv)`), opened in one place, and closed when the process stops.
+  A test opens a file in a temporary folder.
+
+### When to move to SQL
+
+The whole file is kept in memory and rewritten on every write, and one process owns it. Move to `db` when:
+
+- more than one process must write (two writers would overwrite each other);
+- the file grows past a few megabytes, or you need to search, sort or join the data;
+- the data gets relations (users who own notes).
+
+The same `kv` interface runs on SQL, so the code does not change, only the line that opens it. `kvOnDb` keeps the documents in a `kv` table of the
+database from `openDb`, and `copyKv` moves what the file holds:
+
+```ts
+import { copyKv } from 'acrylblends/kv'
+import { openKv } from 'acrylblends/kv/json'
+import { kvOnDb } from 'acrylblends/kv/db'
+import { openDb } from 'acrylblends/db/sqlite'
+
+const file = await openKv({ path: 'data/kv.json' })
+const sql = await openDb({ path: 'data/app.sqlite', migrations: 'migrations' })
+
+const { copied } = await copyKv(file.kv, kvOnDb(sql.db)) // refuses to overwrite a key the table already has, unless you pass { overwrite: true }
+
+await file.close()
+await sql.close()
+```
+
+On the command line, `npx acrylblends kv import data/kv.json data/app.sqlite` does the same (add `--overwrite` to replace keys the table has).
+The table is created on first use, beside the app's own tables; nothing else changes.
 
 ## Open the database
 
@@ -182,6 +246,41 @@ process.once('SIGTERM', async () => {
 copy of `data/app.sqlite` made afterwards is complete. Keep the file on a disk that outlives a deploy; on a host with only an ephemeral disk the
 data goes with the machine.
 
+## Why the database is opened in one place
+
+Only one file of an app opens the database: the **opener** (`src/db.ts` in the templates). Every other file receives a `Db` as an argument and
+imports its type from `acrylblends/db`. Nothing outside the opener imports `node:sqlite`, `pg`, `postgres`, `@electric-sql/pglite` or another
+driver, or `acrylblends/db/sqlite` itself.
+
+Why it matters:
+
+- **Changing the database is one file.** Moving from SQLite to Postgres changes what the opener calls, and no route, store or test.
+- **A test opens its own database.** Code that opens a database by itself cannot be given an in-memory one, and a test that reaches the real file
+  breaks the next one.
+- **There is one place to close it.** The code that opened a database closes it; the port has no `close`, so a route cannot do it by mistake.
+- **An agent that adds a feature keeps the shape.** A coding agent asked for "tags" writes a migration and a store function, and has no reason to
+  reach for a driver when the interface is in front of it.
+
+The rule is checked, not hoped for. The app names its opener once, in `package.json`:
+
+```json
+{
+  "acryl": { "opener": "src/db.ts" }
+}
+```
+
+`acrylblends check-deps` reads every `.ts`, `.tsx` and `.js` file in `src/`, `test/`, `tests/` and `extensions/`, and fails when a file other than
+the opener imports a database driver, an opener such as `acrylblends/db/sqlite` or `acryl-db-sqlite`, or (outside `src/plugins/desktop`) `electron`.
+It names the file and the line:
+
+```
+src/routes.ts:3: "node:sqlite" is a database driver; take a Db (import type { Db } from "acrylblends/db") as an argument and let src/db.ts open the database
+```
+
+The `notes` and `chat` templates run it in `npm test` and `npm run check`. List more than one opener as an array (`"opener": ["src/db.ts", "src/app.ts"]`).
+In a Blend app, `acrylblends add db` declares `src/app.ts`, where the provider is mounted, and a plugin that declares `inject: ['db']` must not import
+`acryl-db-sqlite`: it receives `ctx.db`.
+
 ## In a Cordis app
 
 An ACRYL app gets the same interface as a service. The `acryl-db-sqlite` plugin row opens the file (by default `data.sqlite` in the app home),

package/docs/framework/upstream.json

@@ -2,8 +2,8 @@
   "source": {
     "repo": "acryldev/acryl",
     "path": "docs/framework",
-    "commit": "4721bb00960fa4e157e6070c330cf87c148739fc"
+    "commit": "f8e385e4389fe2fdc6fd2a4366a7f2a7389faacb"
   },
   "files": 99,
-  "digest": "sha256:ce484a4cf2bc9781d188fe468e98c498052d50155bb72f84c0a1ad384b1a5e85"
+  "digest": "sha256:075d537930a53f7ba46b989ff82f9d83a720270c60d848917e6501bfabff6df1"
 }

package/lib/database-D_UN6We8.d.ts

@@ -0,0 +1,44 @@
+//#region ../../plugins/acryl-db/lib/types/facade/database.d.ts
+/** Values supported by the portable SQL drivers. */
+type SqlValue = null | number | bigint | string | Uint8Array;
+/**
+ * Asynchronous SQL operations shared by a database and its transaction handles.
+ *
+ * `exec` runs SQL text without bindings and may contain several statements. `run`, `get`, and `all`
+ * execute one statement with positional bindings. Adapters may cache prepared statements by SQL text,
+ * so callers pass values as bindings instead of interpolating them. `run` resolves the number of rows
+ * the statement changed.
+ */
+interface DbExecutor {
+  exec(sql: string): Promise<void>;
+  run(sql: string, ...params: SqlValue[]): Promise<{
+    readonly changes: number;
+  }>;
+  get<T extends object>(sql: string, ...params: SqlValue[]): Promise<T | undefined>;
+  all<T extends object>(sql: string, ...params: SqlValue[]): Promise<T[]>;
+}
+/**
+ * Minimal portable SQL database facade.
+ *
+ * All operations are asynchronous so adapters may execute outside the caller's runtime.
+ *
+ * `transaction` passes the callback a transaction handle. All work in the transaction
+ * must use that handle; the handle is invalid after the callback settles. Adapters must
+ * queue unrelated operations and other transactions until the transaction finishes. The
+ * returned promise settles after commit or rollback. Calling the database itself (including
+ * `transaction`) from inside a callback therefore waits for that transaction and
+ * never settles.
+ *
+ * When the callback rejects, the adapter must roll the transaction back before rejecting
+ * with that same error. If rollback fails, it must reject with a different error (for
+ * example an `AggregateError`) so callers cannot mistake the callback error for a
+ * guaranteed rollback.
+ *
+ * Closing is the adapter's: the plugin that opened a database closes it, so the facade an
+ * app receives has no `close`.
+ */
+interface Db extends DbExecutor {
+  transaction<T>(callback: (transaction: DbExecutor) => Promise<T>): Promise<T>;
+}
+//#endregion
+export { DbExecutor as n, SqlValue as r, Db as t };

package/lib/db/sqlite.d.ts

@@ -1,4 +1,4 @@
-import { c as DbExecutor, l as SqlValue, s as Db } from "../index-D4FAsBZu.js";
+import { n as DbExecutor, r as SqlValue, t as Db } from "../database-D_UN6We8.js";
 
 //#region ../../plugins/acryl-db-sqlite/src/open.d.ts
 interface OpenDbOptions {

package/lib/db.d.ts

@@ -1,2 +1,85 @@
-import { a as Migration, c as DbExecutor, i as validateSchemaPrefix, l as SqlValue, n as MIGRATIONS_TABLE, o as applyMigrations, r as readMigrationFiles, s as Db, t as DB_SERVICE } from "./index-D4FAsBZu.js";
+//#region ../../plugins/acryl-db/src/facade/database.d.ts
+/** Values supported by the portable SQL drivers. */
+type SqlValue = null | number | bigint | string | Uint8Array;
+/**
+ * Asynchronous SQL operations shared by a database and its transaction handles.
+ *
+ * `exec` runs SQL text without bindings and may contain several statements. `run`, `get`, and `all`
+ * execute one statement with positional bindings. Adapters may cache prepared statements by SQL text,
+ * so callers pass values as bindings instead of interpolating them. `run` resolves the number of rows
+ * the statement changed.
+ */
+interface DbExecutor {
+  exec(sql: string): Promise<void>;
+  run(sql: string, ...params: SqlValue[]): Promise<{
+    readonly changes: number;
+  }>;
+  get<T extends object>(sql: string, ...params: SqlValue[]): Promise<T | undefined>;
+  all<T extends object>(sql: string, ...params: SqlValue[]): Promise<T[]>;
+}
+/**
+ * Minimal portable SQL database facade.
+ *
+ * All operations are asynchronous so adapters may execute outside the caller's runtime.
+ *
+ * `transaction` passes the callback a transaction handle. All work in the transaction
+ * must use that handle; the handle is invalid after the callback settles. Adapters must
+ * queue unrelated operations and other transactions until the transaction finishes. The
+ * returned promise settles after commit or rollback. Calling the database itself (including
+ * `transaction`) from inside a callback therefore waits for that transaction and
+ * never settles.
+ *
+ * When the callback rejects, the adapter must roll the transaction back before rejecting
+ * with that same error. If rollback fails, it must reject with a different error (for
+ * example an `AggregateError`) so callers cannot mistake the callback error for a
+ * guaranteed rollback.
+ *
+ * Closing is the adapter's: the plugin that opened a database closes it, so the facade an
+ * app receives has no `close`.
+ */
+interface Db extends DbExecutor {
+  transaction<T>(callback: (transaction: DbExecutor) => Promise<T>): Promise<T>;
+}
+//#endregion
+//#region ../../plugins/acryl-db/src/facade/migrations.d.ts
+type Migration = {
+  readonly version: number;
+  readonly statements: readonly string[];
+};
+/**
+ * Apply all pending migrations atomically, tracking their version in the named metadata table.
+ *
+ * The bookkeeping SQL runs unchanged on SQLite and Postgres: no `STRICT` table, `ON CONFLICT DO NOTHING`
+ * instead of `INSERT OR IGNORE`, and the version written as a checked integer rather than a binding,
+ * since the two dialects spell placeholders differently.
+ */
+declare function applyMigrations(database: Db, migrations: readonly Migration[], options: {
+  readonly table: string;
+}): Promise<void>;
+//#endregion
+//#region ../../plugins/acryl-db/src/facade/schema.d.ts
+/** Validate a prefix before using it as part of a SQL identifier. */
+declare function validateSchemaPrefix(prefix: string): void;
+//#endregion
+//#region ../../plugins/acryl-db/src/migration-files.d.ts
+/**
+ * Read every `NNN-name.sql` file of a folder, in number order.
+ * @throws when a `.sql` file is not named `NNN-name.sql`, or the numbers do not run 1, 2, 3, ... without gaps or repeats.
+ */
+declare function readMigrationFiles(folder: string | URL): Promise<Migration[]>;
+//#endregion
+//#region ../../plugins/acryl-db/src/index.d.ts
+/**
+ * The `db` port: what an app's code sees of its relational database, whichever provider (`acryl-db-sqlite`, `acryl-db-postgres`) serves
+ * it. Plain code (an acrylblends app) opens a database with a provider's `openDb`; a Cordis plugin declares `inject: ['db']`, imports
+ * `acryl-db/cordis` for the `ctx.db` type, and never imports a driver.
+ *
+ * Bindings are positional `?` placeholders on every provider; a provider whose database spells them differently translates them.
+ * This entry imports nothing from Cordis, at runtime or in its types.
+ */
+/** The service name every `db` provider registers. */
+declare const DB_SERVICE = "db";
+/** The table that records an app's migration version. */
+declare const MIGRATIONS_TABLE = "_migrations";
+//#endregion
 export { DB_SERVICE, type Db, type DbExecutor, MIGRATIONS_TABLE, type Migration, type SqlValue, applyMigrations, readMigrationFiles, validateSchemaPrefix };

package/lib/kv/db.d.ts

@@ -0,0 +1,12 @@
+import { t as Db } from "../database-D_UN6We8.js";
+import { t as Kv } from "../kv-DWDm0Lja.js";
+
+//#region ../../plugins/acryl-kv-db/src/open.d.ts
+interface KvOnDbOptions {
+  /** The table that holds the documents. Defaults to `kv`; a plain SQL identifier. */
+  readonly table?: string;
+}
+/** The `kv` port over a `db`. It does not own the database: whoever opened it closes it, and calls after that reject. */
+declare function kvOnDb(db: Db, options?: KvOnDbOptions): Kv;
+//#endregion
+export { type Kv, KvOnDbOptions, kvOnDb };