create-acrylblends 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,12 @@
1
1
  #!/usr/bin/env node
2
- import { runCreate } from '../dist/index.js'
2
+ // A Node too old to run the package is told so in plain words, before anything is loaded that would fail on it.
3
+ const [major, minor] = process.versions.node.split('.').map(Number)
4
+ if (major < 22 || (major === 22 && minor < 19)) {
5
+ console.error(
6
+ `Node 22.19+ needed, you have ${process.versions.node}: install it from https://nodejs.org or with nvm (nvm install 22).`,
7
+ )
8
+ process.exit(1)
9
+ }
10
+ const { runCreate } = await import('../dist/index.js')
3
11
 
4
12
  process.exitCode = await runCreate(process.argv.slice(2))
package/dist/index.d.ts CHANGED
@@ -60,8 +60,10 @@ export interface CreateOptions {
60
60
  install: boolean;
61
61
  pm: PackageManager | undefined;
62
62
  yes: boolean;
63
- /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */
63
+ /** `github:owner/repo[#ref]`, `@scope/name`, a packed `.tgz`, a folder, or a registry id: a template from outside this package. */
64
64
  source: string | undefined;
65
+ /** Where registry ids are read from; the public registry by default. */
66
+ registry: string | undefined;
65
67
  }
66
68
  export declare function isTemplate(value: string): value is Template;
67
69
  /** The template a name means: itself, or what an old name stands for. */
package/dist/index.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { createRequire } from "node:module";
2
2
  import { spawn, spawnSync } from "node:child_process";
3
- import { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
3
+ import { copyFileSync, cpSync, cpSync as cpSync$1, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
4
4
  import { tmpdir } from "node:os";
5
5
  import { basename, dirname, join, resolve } from "node:path";
6
6
  import { createInterface } from "node:readline/promises";
@@ -27,7 +27,7 @@ const TEMPLATE_MANIFEST = "acryl.template.json";
27
27
  var SourceError = class extends Error {
28
28
  name = "SourceError";
29
29
  };
30
- const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`;
30
+ const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], a packed .tgz file, or a folder (./path)`;
31
31
  const LIMITS = {
32
32
  files: 5e3,
33
33
  bytes: 52428800
@@ -55,6 +55,14 @@ function parseSource(text, cwd) {
55
55
  path
56
56
  };
57
57
  }
58
+ if (/^(\.{1,2}[\\/]|[\\/]|[A-Za-z]:[\\/])/.test(text)) {
59
+ const path = resolve(cwd, text);
60
+ if (!existsSync(path) || !lstatSync(path).isDirectory()) throw new SourceError(`${path} is not a folder`);
61
+ return {
62
+ kind: "folder",
63
+ path
64
+ };
65
+ }
58
66
  }
59
67
  const realFetchers = {
60
68
  async download(url) {
@@ -103,22 +111,39 @@ function extract(tarball, dir) {
103
111
  "--strip-components=1"
104
112
  ], { encoding: "utf8" });
105
113
  if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`);
114
+ checkTree(dir);
115
+ }
116
+ /** Refuse a tree that holds a link, or is larger than the limits; the same check for an unpacked archive and a copied folder. */
117
+ function checkTree(dir) {
106
118
  let bytes = 0;
119
+ let count = 0;
107
120
  const walk = (folder) => {
108
121
  for (const entry of readdirSync(folder)) {
109
122
  const path = join(folder, entry);
110
123
  const info = lstatSync(path);
111
124
  if (info.isSymbolicLink()) throw new SourceError(`the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`);
112
125
  if (info.isDirectory()) walk(path);
113
- else bytes += info.size;
126
+ else {
127
+ bytes += info.size;
128
+ count += 1;
129
+ }
114
130
  }
115
131
  };
116
132
  walk(dir);
133
+ if (count > LIMITS.files) throw new SourceError(`the template has more than ${LIMITS.files} files`);
117
134
  if (bytes > LIMITS.bytes) throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`);
118
135
  }
119
136
  /** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */
120
137
  async function fetchSource(source, dir, scratch, fetchers) {
121
138
  mkdirSync(scratch, { recursive: true });
139
+ if (source.kind === "folder") {
140
+ cpSync$1(source.path, dir, {
141
+ recursive: true,
142
+ filter: (path) => !/[\\/](\.git|node_modules)([\\/]|$)/.test(path.slice(source.path.length))
143
+ });
144
+ checkTree(dir);
145
+ return;
146
+ }
122
147
  let tarball;
123
148
  if (source.kind === "tarball") tarball = source.path;
124
149
  else if (source.kind === "npm") tarball = fetchers.pack(source.spec, scratch);
@@ -204,6 +229,79 @@ const removeTree = (path) => rmSync(path, {
204
229
  recursive: true,
205
230
  force: true
206
231
  });
232
+ /** Where ACRYL app starters are opened. */
233
+ const ACRYL_APP = "https://acryl.dev";
234
+ /** A registry id: dotted, lower case (`acryl.gtd`, `acrylblends.notes-desktop`, `login.thing`). */
235
+ const REGISTRY_ID = /^[a-z0-9][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*)+$/;
236
+ /** The folder of an unpacked registry that holds `index.json`: the root, or its `registry/` folder (the public registry lives in its site's repository). */
237
+ function registryRoot(unpacked) {
238
+ for (const candidate of [unpacked, join(unpacked, "registry")]) if (existsSync(join(candidate, "index.json"))) return candidate;
239
+ throw new SourceError("this registry has no index.json (it is a folder with index.json and blends/<id>/)");
240
+ }
241
+ /** Read the index of an unpacked registry. */
242
+ function readRegistry(unpacked) {
243
+ const root = registryRoot(unpacked);
244
+ let data;
245
+ try {
246
+ data = JSON.parse(readFileSync(join(root, "index.json"), "utf8"));
247
+ } catch {
248
+ throw new SourceError("the registry index.json is not valid JSON");
249
+ }
250
+ const list = data.entries;
251
+ if (!Array.isArray(list)) throw new SourceError("the registry index.json has no entries");
252
+ const entries = [];
253
+ for (const item of list) {
254
+ if (typeof item.id !== "string" || typeof item.path !== "string") continue;
255
+ if (!/^blends\/[^/\\]+$/.test(item.path)) throw new SourceError(`registry entry ${item.id} has no valid path`);
256
+ entries.push({
257
+ id: item.id,
258
+ name: typeof item.name === "string" ? item.name : item.id,
259
+ version: typeof item.version === "string" ? item.version : "0.0.0",
260
+ path: item.path,
261
+ runtime: item.runtime === "acrylblends" ? "acrylblends" : "acryl",
262
+ ...typeof item.description === "string" ? { description: item.description } : {}
263
+ });
264
+ }
265
+ return {
266
+ root,
267
+ entries
268
+ };
269
+ }
270
+ /** The entry for an id. An ACRYL app starter is refused in one line; an unknown id lists the starters this package can make. */
271
+ function pickEntry(entries, id) {
272
+ const entry = entries.find((candidate) => candidate.id === id);
273
+ if (!entry) {
274
+ const mine = entries.filter((candidate) => candidate.runtime === "acrylblends").map((candidate) => candidate.id);
275
+ throw new SourceError(`no starter "${id}" in this registry${mine.length > 0 ? `; starters for create-acrylblends: ${mine.join(", ")}` : ""}`);
276
+ }
277
+ if (entry.runtime !== "acrylblends") throw new SourceError(`${entry.id} is an ACRYL app starter: open it in the ACRYL app (${ACRYL_APP}). create-acrylblends makes acrylblends apps.`);
278
+ return entry;
279
+ }
280
+ /**
281
+ * Give a pulled starter to its new owner: the manifest names the app (`acrylblends.<name>`, private), because the registry's id and its public visibility belong to the starter,
282
+ * not to the app made from it. Changes the `metadata` lines of `blend.yaml` (the id, the name, the visibility; the licence is dropped) and nothing else; a manifest it cannot read that way is left as it is.
283
+ */
284
+ function ownManifest(text, name) {
285
+ const lines = text.split("\n");
286
+ const start = lines.findIndex((line) => /^metadata:\s*$/.test(line));
287
+ if (start < 0) return text;
288
+ let end = start + 1;
289
+ while (end < lines.length && /^\s+\S|^\s*$/.test(lines[end] ?? "")) end += 1;
290
+ const set = (key, value) => {
291
+ for (let at = start + 1; at < end; at += 1) {
292
+ const match = new RegExp(`^(\\s+)${key}:.*$`).exec(lines[at] ?? "");
293
+ if (match) {
294
+ lines[at] = `${match[1]}${key}: ${value}`;
295
+ return;
296
+ }
297
+ }
298
+ };
299
+ set("id", `acrylblends.${name}`);
300
+ set("name", name);
301
+ set("visibility", "private");
302
+ for (let at = end - 1; at > start; at -= 1) if (/^\s+license:/.test(lines[at] ?? "")) lines.splice(at, 1);
303
+ return lines.join("\n");
304
+ }
207
305
  //#endregion
208
306
  //#region src/spawn.ts
209
307
  /**
@@ -277,8 +375,15 @@ A source makes the app from someone else's template (it is downloaded and unpack
277
375
  github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)
278
376
  @scope/name[@version] an npm package (npm pack --ignore-scripts)
279
377
  ./template.tgz a packed template on disk
378
+ ./folder a template folder on disk
280
379
  A template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).
281
380
 
381
+ A starter from the registry is pulled by its id (npm needs the -- before the options):
382
+ npm create ${PACKAGE}@latest my-app -- --from acrylblends.notes-desktop
383
+ --from <id | source> a registry id such as acrylblends.notes-desktop, or any of the sources above
384
+ --registry <source> read the starters from this registry instead of the public one (github:owner/repo, or a folder)
385
+ Only starters made for ${CLASS} (runtime: ${PACKAGE}) are apps this command can make; an ACRYL app starter is refused with a line saying so.
386
+
282
387
  Options:
283
388
  --template <name> one of the templates below (asked when not given); a bare name after the directory means the same
284
389
  (npm create ${PACKAGE}@latest my-app notes). Every template is a Cordis app: blend.yaml, plugins/
@@ -345,13 +450,19 @@ function parseCreateOptions(argv) {
345
450
  const named = values.template === void 0 ? void 0 : resolveTemplate(values.template);
346
451
  if (values.template !== void 0 && named === void 0) throw new UsageError(`unknown template "${values.template}" (${TEMPLATES.join(", ")})`);
347
452
  if (values.pm !== void 0 && !PACKAGE_MANAGERS.includes(values.pm)) throw new UsageError(`unknown package manager "${values.pm}" (${PACKAGE_MANAGERS.join(", ")})`);
453
+ const positionalSource = bare === void 0 ? positionals[1] : void 0;
454
+ if (values.from !== void 0 && positionals[1] !== void 0) throw new UsageError("give --from or a template (or a template source) after the directory, not both");
455
+ if (values.from !== void 0 && values.template !== void 0) throw new UsageError("give --from or --template, not both");
456
+ const source = values.from ?? positionalSource;
457
+ if (values.registry !== void 0 && !(source !== void 0 && REGISTRY_ID.test(source))) throw new UsageError("--registry goes with a registry id: --from <id> --registry <source>");
348
458
  return {
349
459
  directory: positionals[0],
350
460
  template: bare ?? named,
351
461
  install: values.install === true,
352
462
  pm: values.pm,
353
463
  yes: values.yes === true,
354
- source: bare === void 0 ? positionals[1] : void 0
464
+ source,
465
+ registry: values.registry
355
466
  };
356
467
  }
357
468
  const parse = (argv) => parseArgs({
@@ -360,6 +471,8 @@ const parse = (argv) => parseArgs({
360
471
  strict: true,
361
472
  options: {
362
473
  template: { type: "string" },
474
+ from: { type: "string" },
475
+ registry: { type: "string" },
363
476
  install: { type: "boolean" },
364
477
  pm: { type: "string" },
365
478
  yes: {
@@ -446,13 +559,28 @@ async function createFromSource(options, target, directory, io) {
446
559
  }
447
560
  const scratch = mkdtempSync(join(tmpdir(), "create-acrylblends-"));
448
561
  try {
449
- const source = parseSource(options.source, io.cwd);
450
- if (!source) throw new UsageError(`unknown template source "${options.source}" (${SOURCE_FORMS})`);
451
562
  const name = nameFrom(target);
452
- await fetchSource(source, join(scratch, "source"), join(scratch, "download"), io.fetchers ?? realFetchers);
563
+ const fetchers = io.fetchers ?? realFetchers;
564
+ let entry;
565
+ if (REGISTRY_ID.test(options.source)) {
566
+ const registrySource = parseSource(options.registry ?? "github:acrylblends/acrylblends.github.io", io.cwd);
567
+ if (!registrySource) throw new UsageError(`unknown registry "${options.registry}" (${SOURCE_FORMS})`);
568
+ await fetchSource(registrySource, join(scratch, "registry"), join(scratch, "download"), fetchers);
569
+ const registry = readRegistry(join(scratch, "registry"));
570
+ entry = pickEntry(registry.entries, options.source);
571
+ await fetchSource({
572
+ kind: "folder",
573
+ path: join(registry.root, entry.path)
574
+ }, join(scratch, "source"), join(scratch, "download"), fetchers);
575
+ } else {
576
+ const source = parseSource(options.source, io.cwd);
577
+ if (!source) throw new UsageError(`unknown template source "${options.source}" (${SOURCE_FORMS})`);
578
+ await fetchSource(source, join(scratch, "source"), join(scratch, "download"), fetchers);
579
+ }
453
580
  const manifest = readManifest(join(scratch, "source"));
454
581
  const staged = join(scratch, "app");
455
582
  const { files, lifecycle } = writeTemplate(join(scratch, "source"), staged, (text) => replacePlaceholders(text, name), frameworkRange(), name);
583
+ if (entry !== void 0 && existsSync(join(staged, "blend.yaml"))) writeFileSync(join(staged, "blend.yaml"), ownManifest(readFileSync(join(staged, "blend.yaml"), "utf8"), name));
456
584
  if (!existsSync(join(staged, "AGENTS.md"))) writeFileSync(join(staged, "AGENTS.md"), `# ${name}\n\nAn ${CLASS} app made from the template "${manifest.name}": ${manifest.description}\n\nThe framework's API is in \`docs/framework/\` (start at \`docs/framework/README.md\`).\n`);
457
585
  if (!existsSync(join(staged, "CLAUDE.md"))) copyFileSync(join(staged, "AGENTS.md"), join(staged, "CLAUDE.md"));
458
586
  const found = findSecrets(textFiles(staged));
@@ -462,7 +590,7 @@ async function createFromSource(options, target, directory, io) {
462
590
  }
463
591
  copyDocs(staged);
464
592
  cpSync(staged, target, { recursive: true });
465
- io.stdout.write(`created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\n`);
593
+ io.stdout.write(`created ${name} from ${entry ? `${entry.id} ${entry.version}` : manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\n`);
466
594
  if (manifest.plugins.length > 0) io.stdout.write(`it needs these plugins: ${manifest.plugins.join(", ")}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(" ")}\n`);
467
595
  const pm = options.pm ?? PACKAGE_MANAGERS.find((m) => (io.env.npm_config_user_agent ?? "").startsWith(`${m}/`)) ?? "npm";
468
596
  const hasScripts = Object.keys(lifecycle).length > 0;
@@ -521,7 +649,8 @@ async function runCreate(argv, io = processIo()) {
521
649
  template,
522
650
  "--name",
523
651
  name,
524
- "--yes"
652
+ "--yes",
653
+ "--no-next"
525
654
  ], io.cwd) !== 0) return 1;
526
655
  const pm = options.pm ?? PACKAGE_MANAGERS.find((m) => (io.env.npm_config_user_agent ?? "").startsWith(`${m}/`)) ?? "npm";
527
656
  if (options.install) {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/source.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n let bytes = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else bytes += info.size\n }\n }\n walk(dir)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\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 {\n copyFileSync,\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\n/**\n * The templates: the same list as acrylblends init (the framework package makes every one of them; create-acrylblends delegates). A test compares this list and its summaries with the\n * framework package's, so they cannot drift.\n */\nexport const TEMPLATES = ['blank', 'nodejs', 'notes', 'chat', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const TEMPLATE_SUMMARY: Record<Template, string> = {\n blank: 'the router, a server and one route: the smallest app',\n nodejs: 'a web app with a page and a client component',\n notes: 'a multi-user notes app on the db port (sign-up, log-in, sessions)',\n chat: 'a chat app that streams an answer over server-sent events',\n todo: 'a to-do list on the router and state',\n agent: 'the blank app with an offline agent that builds plugins into the running app',\n}\n/** Names that were templates once and still work. */\nexport const TEMPLATE_ALIASES: Record<string, Template> = { 'acryl-app': 'agent' }\nconst TEMPLATE_LIST = TEMPLATES.map((name) => ` ${name.padEnd(7)} ${TEMPLATE_SUMMARY[name]}`).join(\n '\\n',\n)\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\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 = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [template | source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nOptions:\n --template <name> one of the templates below (asked when not given); a bare name after the directory means the same\n (npm create ${PACKAGE}@latest my-app notes). Every template is a Cordis app: blend.yaml, plugins/\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n\nTemplates (the same list as acrylblends init):\n${TEMPLATE_LIST}\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\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 env: process.env,\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 run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */\n source: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/** The template a name means: itself, or what an old name stands for. */\nexport function resolveTemplate(value: string): Template | undefined {\n return isTemplate(value) ? value : TEMPLATE_ALIASES[value]\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\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 > 2)\n throw new UsageError('takes a directory and at most one template source')\n // A bare name that is a built-in template means --template: `create my-app notes`. Only github:, @scope/ and .tgz are sources.\n const bare = positionals[1] !== undefined ? resolveTemplate(positionals[1]) : undefined\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template (or a template source) or --template, not both')\n const named = values.template === undefined ? undefined : resolveTemplate(values.template)\n if (values.template !== undefined && named === undefined)\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n return {\n directory: positionals[0],\n template: bare ?? named,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source: bare === undefined ? positionals[1] : undefined,\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates every template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n const name = nameFrom(target)\n await fetchSource(\n source,\n join(scratch, 'source'),\n join(scratch, 'download'),\n io.fetchers ?? realFetchers,\n )\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n copyFileSync(join(staged, 'AGENTS.md'), join(staged, 'CLAUDE.md'))\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Templates:\\n${TEMPLATE_LIST}\\nWhich template do you want to use? [nodejs]: `,\n )\n ).trim() || 'nodejs'\n const chosen = resolveTemplate(answer)\n if (chosen === undefined)\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return chosen\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n // Every template is a Cordis app, made by the framework package's own `init` (blend.yaml, plugins/, AGENTS.md, CLAUDE.md, the skill, the docs).\n const code = await io.run(\n process.execPath,\n [acrylblendsBin(), 'init', target, '--template', template, '--name', name, '--yes'],\n io.cwd,\n )\n if (code !== 0) return 1\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = `${pm} run dev`\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\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 as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/source.ts","../src/registry.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n | { kind: 'folder'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], a packed .tgz file, or a folder (./path)`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n // A folder is only a source when it is written as a path, so a template name is never taken for one.\n if (/^(\\.{1,2}[\\\\/]|[\\\\/]|[A-Za-z]:[\\\\/])/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path) || !lstatSync(path).isDirectory())\n throw new SourceError(`${path} is not a folder`)\n return { kind: 'folder', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n checkTree(dir)\n}\n\n/** Refuse a tree that holds a link, or is larger than the limits; the same check for an unpacked archive and a copied folder. */\nexport function checkTree(dir: string): void {\n let bytes = 0\n let count = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else {\n bytes += info.size\n count += 1\n }\n }\n }\n walk(dir)\n if (count > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n if (source.kind === 'folder') {\n cpSync(source.path, dir, {\n recursive: true,\n filter: (path) => !/[\\\\/](\\.git|node_modules)([\\\\/]|$)/.test(path.slice(source.path.length)),\n })\n checkTree(dir)\n return\n }\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\n","/**\n * Starters from a registry: `npm create acrylblends@latest my-app -- --from acryl.example`. A registry is a git repository (or a folder) with an `index.json` and one folder per\n * starter under `blends/<id>/`. Its CI says in the index which runtime an entry is for: only `runtime: acrylblends` entries are apps this package can make (the folder is the\n * app, with an `acryl.template.json`); the others are ACRYL app starters and are refused with one line. Nothing is run: the entry is downloaded, unpacked and copied.\n */\nimport { existsSync, readFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { SourceError } from './source'\n\n/** The public registry, read from its repository (the same files the site lists). */\nexport const DEFAULT_REGISTRY = 'github:acrylblends/acrylblends.github.io'\n\n/** Where ACRYL app starters are opened. */\nexport const ACRYL_APP = 'https://acryl.dev'\n\n/** A registry id: dotted, lower case (`acryl.gtd`, `acrylblends.notes-desktop`, `login.thing`). */\nexport const REGISTRY_ID = /^[a-z0-9][a-z0-9-]*(\\.[a-z0-9][a-z0-9-]*)+$/\n\nexport interface RegistryEntry {\n readonly id: string\n readonly name: string\n readonly version: string\n /** The entry's folder inside the registry, `blends/<id>`. */\n readonly path: string\n /** `acrylblends` (an app this package makes) or `acryl` (an ACRYL app starter). An index written before the field existed has none: those entries are ACRYL's. */\n readonly runtime: 'acrylblends' | 'acryl'\n readonly description?: string\n}\n\n/** The folder of an unpacked registry that holds `index.json`: the root, or its `registry/` folder (the public registry lives in its site's repository). */\nexport function registryRoot(unpacked: string): string {\n for (const candidate of [unpacked, join(unpacked, 'registry')])\n if (existsSync(join(candidate, 'index.json'))) return candidate\n throw new SourceError(\n 'this registry has no index.json (it is a folder with index.json and blends/<id>/)',\n )\n}\n\n/** Read the index of an unpacked registry. */\nexport function readRegistry(unpacked: string): { root: string; entries: RegistryEntry[] } {\n const root = registryRoot(unpacked)\n let data: unknown\n try {\n data = JSON.parse(readFileSync(join(root, 'index.json'), 'utf8'))\n } catch {\n throw new SourceError('the registry index.json is not valid JSON')\n }\n const list = (data as { entries?: unknown }).entries\n if (!Array.isArray(list)) throw new SourceError('the registry index.json has no entries')\n const entries: RegistryEntry[] = []\n for (const item of list as Record<string, unknown>[]) {\n if (typeof item.id !== 'string' || typeof item.path !== 'string') continue\n if (!/^blends\\/[^/\\\\]+$/.test(item.path))\n throw new SourceError(`registry entry ${item.id} has no valid path`)\n entries.push({\n id: item.id,\n name: typeof item.name === 'string' ? item.name : item.id,\n version: typeof item.version === 'string' ? item.version : '0.0.0',\n path: item.path,\n runtime: item.runtime === 'acrylblends' ? 'acrylblends' : 'acryl',\n ...(typeof item.description === 'string' ? { description: item.description } : {}),\n })\n }\n return { root, entries }\n}\n\n/** The entry for an id. An ACRYL app starter is refused in one line; an unknown id lists the starters this package can make. */\nexport function pickEntry(entries: readonly RegistryEntry[], id: string): RegistryEntry {\n const entry = entries.find((candidate) => candidate.id === id)\n if (!entry) {\n const mine = entries\n .filter((candidate) => candidate.runtime === 'acrylblends')\n .map((candidate) => candidate.id)\n throw new SourceError(\n `no starter \"${id}\" in this registry${mine.length > 0 ? `; starters for create-acrylblends: ${mine.join(', ')}` : ''}`,\n )\n }\n if (entry.runtime !== 'acrylblends')\n throw new SourceError(\n `${entry.id} is an ACRYL app starter: open it in the ACRYL app (${ACRYL_APP}). create-acrylblends makes acrylblends apps.`,\n )\n return entry\n}\n\n/**\n * Give a pulled starter to its new owner: the manifest names the app (`acrylblends.<name>`, private), because the registry's id and its public visibility belong to the starter,\n * not to the app made from it. Changes the `metadata` lines of `blend.yaml` (the id, the name, the visibility; the licence is dropped) and nothing else; a manifest it cannot read that way is left as it is.\n */\nexport function ownManifest(text: string, name: string): string {\n const lines = text.split('\\n')\n const start = lines.findIndex((line) => /^metadata:\\s*$/.test(line))\n if (start < 0) return text\n let end = start + 1\n while (end < lines.length && /^\\s+\\S|^\\s*$/.test(lines[end] ?? '')) end += 1\n const set = (key: string, value: string) => {\n for (let at = start + 1; at < end; at += 1) {\n const match = new RegExp(`^(\\\\s+)${key}:.*$`).exec(lines[at] ?? '')\n if (match) {\n lines[at] = `${match[1]}${key}: ${value}`\n return\n }\n }\n }\n set('id', `acrylblends.${name}`)\n set('name', name)\n set('visibility', 'private')\n // The starter's licence is the starter's: the new app names none until its owner chooses one.\n for (let at = end - 1; at > start; at -= 1)\n if (/^\\s+license:/.test(lines[at] ?? '')) lines.splice(at, 1)\n return lines.join('\\n')\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 {\n copyFileSync,\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport {\n DEFAULT_REGISTRY,\n ownManifest,\n pickEntry,\n REGISTRY_ID,\n type RegistryEntry,\n readRegistry,\n} from './registry'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\n/**\n * The templates: the same list as acrylblends init (the framework package makes every one of them; create-acrylblends delegates). A test compares this list and its summaries with the\n * framework package's, so they cannot drift.\n */\nexport const TEMPLATES = ['blank', 'nodejs', 'notes', 'chat', 'todo', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const TEMPLATE_SUMMARY: Record<Template, string> = {\n blank: 'the router, a server and one route: the smallest app',\n nodejs: 'a web app with a page and a client component',\n notes: 'a multi-user notes app on the db port (sign-up, log-in, sessions)',\n chat: 'a chat app that streams an answer over server-sent events',\n todo: 'a to-do list on the router and state',\n agent: 'the blank app with an offline agent that builds plugins into the running app',\n}\n/** Names that were templates once and still work. */\nexport const TEMPLATE_ALIASES: Record<string, Template> = { 'acryl-app': 'agent' }\nconst TEMPLATE_LIST = TEMPLATES.map((name) => ` ${name.padEnd(7)} ${TEMPLATE_SUMMARY[name]}`).join(\n '\\n',\n)\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\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 = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [template | source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\n ./folder a template folder on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nA starter from the registry is pulled by its id (npm needs the -- before the options):\n npm create ${PACKAGE}@latest my-app -- --from acrylblends.notes-desktop\n --from <id | source> a registry id such as acrylblends.notes-desktop, or any of the sources above\n --registry <source> read the starters from this registry instead of the public one (github:owner/repo, or a folder)\nOnly starters made for ${CLASS} (runtime: ${PACKAGE}) are apps this command can make; an ACRYL app starter is refused with a line saying so.\n\nOptions:\n --template <name> one of the templates below (asked when not given); a bare name after the directory means the same\n (npm create ${PACKAGE}@latest my-app notes). Every template is a Cordis app: blend.yaml, plugins/\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n\nTemplates (the same list as acrylblends init):\n${TEMPLATE_LIST}\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\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 env: process.env,\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 run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name`, a packed `.tgz`, a folder, or a registry id: a template from outside this package. */\n source: string | undefined\n /** Where registry ids are read from; the public registry by default. */\n registry: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\n/** The template a name means: itself, or what an old name stands for. */\nexport function resolveTemplate(value: string): Template | undefined {\n return isTemplate(value) ? value : TEMPLATE_ALIASES[value]\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\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 > 2)\n throw new UsageError('takes a directory and at most one template source')\n // A bare name that is a built-in template means --template: `create my-app notes`. Only github:, @scope/ and .tgz are sources.\n const bare = positionals[1] !== undefined ? resolveTemplate(positionals[1]) : undefined\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template (or a template source) or --template, not both')\n const named = values.template === undefined ? undefined : resolveTemplate(values.template)\n if (values.template !== undefined && named === undefined)\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n const positionalSource = bare === undefined ? positionals[1] : undefined\n if (values.from !== undefined && positionals[1] !== undefined)\n throw new UsageError(\n 'give --from or a template (or a template source) after the directory, not both',\n )\n if (values.from !== undefined && values.template !== undefined)\n throw new UsageError('give --from or --template, not both')\n const source = values.from ?? positionalSource\n if (values.registry !== undefined && !(source !== undefined && REGISTRY_ID.test(source)))\n throw new UsageError('--registry goes with a registry id: --from <id> --registry <source>')\n return {\n directory: positionals[0],\n template: bare ?? named,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source,\n registry: values.registry,\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n from: { type: 'string' },\n registry: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates every template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const name = nameFrom(target)\n const fetchers = io.fetchers ?? realFetchers\n let entry: RegistryEntry | undefined\n if (REGISTRY_ID.test(options.source!)) {\n // A registry id: read the registry's index, pick the entry (only an app for this runtime), and take its folder as the template.\n const registrySource = parseSource(options.registry ?? DEFAULT_REGISTRY, io.cwd)\n if (!registrySource)\n throw new UsageError(`unknown registry \"${options.registry}\" (${SOURCE_FORMS})`)\n await fetchSource(\n registrySource,\n join(scratch, 'registry'),\n join(scratch, 'download'),\n fetchers,\n )\n const registry = readRegistry(join(scratch, 'registry'))\n entry = pickEntry(registry.entries, options.source!)\n await fetchSource(\n { kind: 'folder', path: join(registry.root, entry.path) },\n join(scratch, 'source'),\n join(scratch, 'download'),\n fetchers,\n )\n } else {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n await fetchSource(source, join(scratch, 'source'), join(scratch, 'download'), fetchers)\n }\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (entry !== undefined && existsSync(join(staged, 'blend.yaml')))\n writeFileSync(\n join(staged, 'blend.yaml'),\n ownManifest(readFileSync(join(staged, 'blend.yaml'), 'utf8'), name),\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n copyFileSync(join(staged, 'AGENTS.md'), join(staged, 'CLAUDE.md'))\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${entry ? `${entry.id} ${entry.version}` : manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Templates:\\n${TEMPLATE_LIST}\\nWhich template do you want to use? [nodejs]: `,\n )\n ).trim() || 'nodejs'\n const chosen = resolveTemplate(answer)\n if (chosen === undefined)\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return chosen\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n // Every template is a Cordis app, made by the framework package's own `init` (blend.yaml, plugins/, AGENTS.md, CLAUDE.md, the skill, the docs).\n const code = await io.run(\n process.execPath,\n [\n acrylblendsBin(),\n 'init',\n target,\n '--template',\n template,\n '--name',\n name,\n '--yes',\n '--no-next',\n ],\n io.cwd,\n )\n if (code !== 0) return 1\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = `${pm} run dev`\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\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 as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
@@ -33,6 +33,24 @@ The `agent` template (a Cordis app; `acryl-app` is its old name and still works)
33
33
 
34
34
  See [Acryl in a Cordis app](../cordis/acryl-in-a-cordis-app.md), [Plugin lifecycle](../cordis/plugin-lifecycle.md) and [Mounting](../cordis/mounting.md).
35
35
 
36
+ ## The agent panel and the terminals
37
+
38
+ The panel is a chat button on every page of the running app, and `driver-pty` adds real terminals to it. Both are **development only** (see [what runs in production](../guides/production.md)). They need the rows of the `agent` template (`agent` and `extensions`, with the `model`, `tools` and `memory` the agent brings), so start from that template:
39
+
40
+ ```sh
41
+ npm create acrylblends@latest my-app agent
42
+ cd my-app
43
+ npm install
44
+ npx acrylblends add agent-panel driver-pty
45
+ npm install
46
+ npm run dev
47
+ ```
48
+
49
+ - `add` puts the `agent-panel` row (and `driver-pty`'s after it) in `blend.yaml` before the `routes` row and registers both in `src/app.ts`. On an app without the `agent` and `extensions` rows, such as `blank`, it refuses before it copies anything and says which rows are missing.
50
+ - **The panel's coding agents are yours.** `claude`, `codex` and `pi` run on the machine that runs the app, in the app folder, with the login of the person who started it: `claude` and `codex` use their own signed-in sessions, and `pi` is offered when `DEEPSEEK_API_KEY` is set or `pi` has stored a DeepSeek login (`~/.pi/agent/auth.json`). A program that is not installed, or is not logged in, is not offered; nothing is shared between machines, and a workshop laptop needs its own login. The panel's own `agent` (the offline scripted one) needs none.
51
+ - `pi` has to be an executable on the `PATH`; a shell function that wraps the binary is fine as long as the binary itself is found by `which pi`.
52
+ - `driver-pty` brings `node-pty`, which ships prebuilt binaries for macOS, Windows and Linux. npm 11 and pnpm warn that its install script was not run (they ask you to approve dependency install scripts); you can ignore the warning. If no `pty:` terminal is offered and the app prints why at start, approve and rebuild: `npm approve-scripts node-pty`, then `npm rebuild node-pty` (pnpm: `pnpm approve-builds`).
53
+
36
54
  ## Checking that an agent can use the docs
37
55
 
38
56
  The repository has a manual gate: it creates a fresh app, starts a headless coding agent inside it with a one-line task (for example "add a /customers/count route with a test"),
@@ -7,12 +7,13 @@
7
7
  An app made by `acrylblends init` carries copies of the framework plugins (`acryl-router`, `acryl-node-server`, `acryl-door`, `extensions`, ...) in `plugins/`. `acrylblends upgrade` brings them to the version of the installed package:
8
8
 
9
9
  ```sh
10
- npm install acrylblends@latest # in an app that depends on the package; the agent template does not
11
- npx acrylblends upgrade --dry-run # what would change, and the diff of every file you edited
12
- npx acrylblends upgrade # do it
10
+ npx acrylblends@latest upgrade --dry-run # what would change, and the diff of every file you edited
11
+ npx acrylblends@latest upgrade # do it
13
12
  npm install && npm run check && npm test
14
13
  ```
15
14
 
15
+ **Write `@latest`.** A bare `npx acrylblends upgrade` runs the `acrylblends` the app has installed, and an app made before 1.0 has a 0.x copy with no `upgrade` verb. It does not upgrade anything: depending on the platform and the version it prints its old help and exits 0 (so nothing happens and nothing says so), or answers "unknown command" and exits 2. `npx acrylblends@latest` fetches the current package and runs that. (After the first upgrade the app depends on 1.x, and the bare form works too.)
16
+
16
17
  - A file nobody edited is replaced. A file the app edited stops the upgrade: nothing is changed, the diff of what would be lost is shown, and the command exits 1. Move your change out of the plugin (a plugin of your own in `plugins/<name>/` is never touched), or run `npx acrylblends upgrade --force`, which saves the edited versions in `.acrylblends/upgrade-backup/<time>/` before replacing them.
17
18
  - `--diff` prints the diff of every changed file, not only the edited ones. `acrylblends upgrade acryl-router extensions` upgrades only those plugins.
18
19
  - A file of your own inside a library plugin folder (a note, a test) is kept and reported. A plugin that a newer version needs and the app lacks is added.
@@ -36,6 +36,26 @@ In a Blend app, the same two commands (`npx acrylblends add desktop`, `npm insta
36
36
  `npm install` does not download Electron's binary (Electron 44 has no install script). The first `npm run desktop` does: about 100 MB, once per machine, then it is cached. Behind a proxy or mirror set `ELECTRON_MIRROR`
37
37
  (and `ELECTRON_CACHE` to reuse a download); if the download is blocked, run `npx install-electron` where the mirror is reachable.
38
38
 
39
+ ## Linux: Ubuntu 23.10 and later
40
+
41
+ Ubuntu 23.10 and later restrict unprivileged user namespaces (`kernel.apparmor_restrict_unprivileged_userns=1`). Chromium's sandbox needs them, and an Electron unpacked by npm into `node_modules` has no AppArmor profile, so Electron stops at the start with "The SUID sandbox helper binary was found, but is not configured correctly" before the app runs.
42
+
43
+ `npm run desktop` starts through `plugins/desktop/launch.ts`, which reads that sysctl. **Only when it is `1` on Linux** it starts Electron with `--no-sandbox` and prints one line saying so; on macOS, on Windows and on any Linux without the restriction Electron starts with its sandbox, as it always does. The window's renderer is still locked down (context isolation, no Node in the page, web security); what is lost is Chromium's process sandbox around it.
44
+
45
+ To keep the sandbox, give Electron an AppArmor profile that allows `userns`, as the VS Code and Chrome `.deb` packages do. Save this as `/etc/apparmor.d/my-app-electron` (the path is the one in your app's `node_modules`), then `sudo apparmor_parser -r /etc/apparmor.d/my-app-electron`:
46
+
47
+ ```text
48
+ abi <abi/4.0>,
49
+ include <tunables/global>
50
+
51
+ profile my-app-electron /path/to/my-app/node_modules/electron/dist/electron flags=(unconfined) {
52
+ userns,
53
+ include if exists <local/my-app-electron>
54
+ }
55
+ ```
56
+
57
+ The launcher then still sees the sysctl as `1` and passes `--no-sandbox`; set `ACRYLBLENDS_DESKTOP_SANDBOX=1` to start with the sandbox anyway.
58
+
39
59
  ## A different start page
40
60
 
41
61
  The window opens on `/`. To open another path, set it in `package.json`: `"acrylblends": { "desktopPath": "/todo" }`.
@@ -54,6 +54,8 @@ bun create acrylblends@latest my-app --template nodejs
54
54
  | `[directory]` | The folder to create. It must not exist or must be empty. Asked for when it is missing. | `my-app` |
55
55
  | `[source]` | A template from outside the package: `github:owner/repo[#ref]`, `@scope/name[@version]` or a packed `.tgz` file. See [Templates from a repository or a package](#templates-from-a-repository-or-a-package). | `github:acme/starter` |
56
56
  | `--template <template>` | One of `blank`, `nodejs`, `notes`, `chat`, `todo`, `agent` (the same list as `acrylblends init --template`; `acryl-app` is accepted as `agent`). Skips the template question; a bare name after the directory means the same. | `--template notes` |
57
+ | `--from <id \| source>` | A starter from the registry by its id (`acrylblends.notes-desktop`), or any source above. Only starters that declare `runtime: acrylblends` are made; an ACRYL app starter is refused. See [Starters from the registry](#starters-from-the-registry). | `-- --from acrylblends.notes-desktop` |
58
+ | `--registry <source>` | Read the ids from this registry instead of the public one: `github:owner/repo` or a folder, with an `index.json` (at its root or in `registry/`). | `-- --from login.thing --registry github:acryldev/workshop-2026-11-20` |
57
59
  | `--install` | Install the dependencies with the package manager after creating the project. For a template from a source, the install scripts it will run are listed first. | `--install` |
58
60
  | `--pm <packageManager>` | The package manager for `--install`: `npm`, `pnpm`, `yarn` or `bun`. Defaults to the one that started the initializer. | `--pm pnpm` |
59
61
  | `--yes`, `-y` | Ask nothing: use `nodejs` unless `--template` is given, and the directory `acryl-app`. | `-y` |
@@ -61,6 +63,25 @@ bun create acrylblends@latest my-app --template nodejs
61
63
 
62
64
  The templates are inside the package, so creating a project needs no network except for `--install`.
63
65
 
66
+ ## Starters from the registry
67
+
68
+ The [registry](https://acrylblends.github.io/blends) lists starters people published. Each is a whole app (`blend.yaml`, `plugins/`, `src/`, `package.json`, `README.md`) that other people can start from, and its index says which runtime it is for:
69
+
70
+ ```sh
71
+ npm create acrylblends@latest my-notes -- --from acrylblends.notes-desktop
72
+ cd my-notes
73
+ npm install
74
+ npm run dev
75
+ ```
76
+
77
+ - npm needs the `--` before `--from`; with `pnpm`, `yarn` and `bun` it is not needed.
78
+ - A starter with `runtime: acrylblends` is an `acrylblends` app: this command downloads its folder, gives the manifest to the new app (`metadata.id: acrylblends.my-notes`, `visibility: private`; the starter's id and licence stay the starter's), checks it for anything that looks like a secret, and writes it. Nothing in it is installed or run: `npm install` is yours to run, and the dependencies of the starter (a desktop starter brings `electron`) are in its `package.json`.
79
+ - A starter for the ACRYL app (`runtime: acryl`, the older `acryl.*` entries) is refused with one line that says so, because its plugins run only inside the ACRYL app. Nothing is written.
80
+ - An unknown id lists the starters this command can make.
81
+ - The ids come from `https://acrylblends.github.io/registry/index.json`. `--registry github:owner/repo` reads another registry with the same layout (`index.json` and `blends/<id>/`), a team's own or a workshop's; `--registry ./folder` reads one on disk.
82
+
83
+ To publish a starter of your own, see [the registry README](https://github.com/acrylblends/acrylblends.github.io/tree/main/registry): the folder of your app under `blends/<id>/` with an `acryl.template.json`, in a pull request.
84
+
64
85
  ## Templates from a repository or a package
65
86
 
66
87
  A second argument after the directory makes the app from someone else's template:
@@ -11,6 +11,7 @@
11
11
  | **The agent panel** (`agent-panel`) | **experimental**: a script tag on every HTML page and `/api/agent-panel/*` | does nothing (no tag, no routes). `ACRYL_DOOR=off` too |
12
12
  | **The PTY driver** (`driver-pty`) | **experimental**: terminal drivers in the panel, `/api/driver-pty/*` | does nothing. `ACRYL_DOOR=off` too |
13
13
  | **Live plugin install and the agent** (`extensions`, `builder`, `agent`: `POST /ask`) | **experimental**: install, update, remove and reload plugins while the app runs; the agent builds them | left out: the `nodejs`, `notes` and `chat` templates drop the `extensions` row, and the `agent` template drops `agent`, `builder` and `extensions` (since 1.0.1) unless `ACRYL_PRODUCTION_KEEP` names them |
14
+ | **The chat template's model endpoint** (`POST /api/chat`) | answers anyone | **closed** (503) unless `CHAT_ACCESS_TOKEN` is set, or `ACRYL_PRODUCTION_KEEP=chat` makes it public with a warning and a per-address limit (since 1.0.2) |
14
15
  | `acrylblends/bun` | **experimental**: one smoke gate runs it on Bun | the same |
15
16
 
16
17
  Experimental means: it works and is gated, its interface may still change in a minor version, and it is not for the public internet. The door and the panel are loopback and own-page only, with a per-run secret and an audit log; that is a convenience fence for a developer's machine, not an authentication system.
@@ -22,6 +23,15 @@ The `agent` template mounts an agent behind `POST /ask` that spends the model ke
22
23
  - To keep a row anyway, name it: `ACRYL_PRODUCTION_KEEP=agent,builder,extensions` (a comma list). Each row kept prints a `WARNING` line at start saying what it gives a visitor. Put your own login in front before you do.
23
24
  - **An app made by 1.0.0 keeps its own `src/app.ts` and `src/routes.ts`**, which `acrylblends upgrade` never touches (they are your files). Until you change them: deploy with the `agent`, `builder` and `extensions` rows set to `disabled: true` in `blend.yaml`, or start from another template, or copy the new `src/app.ts` and `src/routes.ts` of a fresh `acrylblends init my-app --template agent` over yours.
24
25
 
26
+ ## The `chat` template in production
27
+
28
+ The chat template answers with the owner's model key, so anyone who can reach it spends that key. Since 1.0.2, with `NODE_ENV=production` it is **closed**: every route but `GET /health` answers 503 until you choose one of:
29
+
30
+ - `CHAT_ACCESS_TOKEN=<a long random string>`: the browser asks for a login and takes any user name with the token as the password. Share the token with the people who may use the chat.
31
+ - `ACRYL_PRODUCTION_KEEP=chat`: the chat is public, with a `WARNING` line at start and a limit of `CHAT_RATE_PER_MINUTE` messages a minute from one address (default 20; behind a proxy you run, set `TRUST_PROXY=1` so the limit counts the visitor, not the proxy). Prefer your own login in front.
32
+
33
+ An app made by 1.0.0 or 1.0.1 keeps its own `src/routes.ts`: copy `src/access.ts`, `src/chat-app.ts` and `src/routes.ts` from a fresh `acrylblends init my-app --template chat`, or put a login in front.
34
+
25
35
  ## What live plugin install does and does not promise
26
36
 
27
37
  Installing a plugin (`ctx.extensions.install`, the door's `plugin add`, the builder's `install_plugin`) is a **correctness check, not a security boundary**:
@@ -41,6 +51,6 @@ Installing a plugin (`ctx.extensions.install`, the door's `plugin add`, the buil
41
51
  ## Checklist for a deployment
42
52
 
43
53
  1. `NODE_ENV=production` (the process manager or the Dockerfile sets it; the templates' Dockerfile does).
44
- 2. With the `agent` template, leave `ACRYL_PRODUCTION_KEEP` unset (1.0.1 and later), or remove the agent rows.
54
+ 2. With the `agent` template, leave `ACRYL_PRODUCTION_KEEP` unset (1.0.1 and later), or remove the agent rows. With the `chat` template, set `CHAT_ACCESS_TOKEN` (1.0.2 and later) or put your own login in front.
45
55
  3. Do not set `allowInProduction` on the door unless the host is a single-user desktop app.
46
56
  4. Keep `ACRYL_DOOR=off` in any environment where an agent should not be able to see the page.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-acrylblends",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "description": "Create an Acryl app: npm create acrylblends@latest",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -36,7 +36,7 @@
36
36
  "scaffold"
37
37
  ],
38
38
  "dependencies": {
39
- "acrylblends": "^1.0.1",
39
+ "acrylblends": "^1.0.2",
40
40
  "@webboxes/app-persistence": "0.1.1"
41
41
  },
42
42
  "publishConfig": {