tutorial-forge-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Brecht
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# tutorial-forge-cli
+
+CLI for [`tutorial-forge`](https://www.npmjs.com/package/tutorial-forge) — render scripted Playwright walkthroughs into narrated tutorial videos.
+
+```sh
+pnpm add -D tutorial-forge tutorial-forge-cli playwright
+
+tutorial-forge render          # render every *.tutorial.ts per forge.config.ts
+tutorial-forge list            # discovered tutorials
+tutorial-forge doctor          # check node / ffmpeg / playwright / TTS env
+tutorial-forge clean --cache   # remove work dirs and the TTS cache
+```
+
+Installed as `tutorial-forge` with a shorter `tforge` alias.
+
+**Full documentation: [github.com/jbrecht/tutorial-forge](https://github.com/jbrecht/tutorial-forge)**

package/dist/clean.d.ts

@@ -0,0 +1,3 @@
+export declare function cleanCommand(opts: {
+    cache?: boolean;
+}): Promise<void>;

package/dist/clean.js

@@ -0,0 +1,14 @@
+import { join } from 'node:path';
+import { rm } from 'node:fs/promises';
+import { defaultCacheDir } from 'tutorial-forge';
+export async function cleanCommand(opts) {
+    const workRoot = join(process.cwd(), '.forge');
+    await rm(workRoot, { recursive: true, force: true });
+    console.log(`removed ${workRoot}`);
+    if (opts.cache) {
+        const cache = defaultCacheDir();
+        await rm(cache, { recursive: true, force: true });
+        console.log(`removed ${cache}`);
+    }
+}
+//# sourceMappingURL=clean.js.map

package/dist/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../src/clean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1 @@
+export declare function doctorCommand(): Promise<void>;

package/dist/doctor.js

@@ -0,0 +1,49 @@
+import { existsSync } from 'node:fs';
+import { ffmpegVersion } from 'tutorial-forge';
+export async function doctorCommand() {
+    const checks = [];
+    const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+    checks.push({
+        name: 'node',
+        ok: nodeMajor >= 20,
+        detail: `v${process.versions.node}${nodeMajor >= 20 ? '' : ' (need >= 20)'}`,
+    });
+    const ffmpeg = await ffmpegVersion('ffmpeg');
+    const ffmpegMajor = ffmpeg ? parseInt(ffmpeg, 10) : 0;
+    checks.push({
+        name: 'ffmpeg',
+        ok: !!ffmpeg && (Number.isNaN(ffmpegMajor) || ffmpegMajor >= 6),
+        detail: ffmpeg ? `version ${ffmpeg}${!Number.isNaN(ffmpegMajor) && ffmpegMajor < 6 ? ' (need >= 6)' : ''}` : 'not found on PATH',
+    });
+    const ffprobe = await ffmpegVersion('ffprobe');
+    checks.push({ name: 'ffprobe', ok: !!ffprobe, detail: ffprobe ? `version ${ffprobe}` : 'not found on PATH' });
+    try {
+        const { chromium } = await import('playwright');
+        const exe = chromium.executablePath();
+        const installed = !!exe && existsSync(exe);
+        checks.push({
+            name: 'playwright chromium',
+            ok: installed,
+            detail: installed ? exe : 'not installed — run: npx playwright install chromium',
+        });
+    }
+    catch {
+        checks.push({ name: 'playwright chromium', ok: false, detail: 'playwright not installed' });
+    }
+    for (const env of ['ELEVENLABS_API_KEY', 'OPENAI_API_KEY']) {
+        checks.push({
+            name: env,
+            ok: true, // informational: only needed if that provider is configured
+            detail: process.env[env] ? 'set' : 'not set (only needed for that provider)',
+        });
+    }
+    let failed = false;
+    for (const c of checks) {
+        console.log(`${c.ok ? '✓' : '✗'} ${c.name.padEnd(22)} ${c.detail}`);
+        if (!c.ok)
+            failed = true;
+    }
+    if (failed)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/list.d.ts

@@ -0,0 +1,3 @@
+export declare function listCommand(globs: string[], opts: {
+    config?: string;
+}): Promise<void>;

package/dist/list.js

@@ -0,0 +1,15 @@
+import { loadConfig, discoverTutorials } from './load.js';
+export async function listCommand(globs, opts) {
+    const cwd = process.cwd();
+    const config = await loadConfig(cwd, opts.config);
+    const patterns = globs.length > 0 ? globs : config.tutorials ?? ['**/*.tutorial.ts'];
+    const discovered = await discoverTutorials(cwd, patterns);
+    if (discovered.length === 0) {
+        console.log(`No tutorials matched ${patterns.join(', ')}`);
+        return;
+    }
+    for (const { tutorial, file } of discovered) {
+        console.log(`${tutorial.id}  "${tutorial.title}"  ${tutorial.steps.length} steps  (${file})`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAe,EAAE,IAAyB;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,YAAY,IAAI,GAAG,CAAC,CAAC;IAChG,CAAC;AACH,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,7 @@
+import { type ForgeConfig, type Tutorial } from 'tutorial-forge';
+export declare function loadConfig(cwd: string, explicitPath?: string): Promise<ForgeConfig>;
+export interface DiscoveredTutorial {
+    tutorial: Tutorial;
+    file: string;
+}
+export declare function discoverTutorials(cwd: string, globs: string[]): Promise<DiscoveredTutorial[]>;

package/dist/load.js

@@ -0,0 +1,62 @@
+import { resolve } from 'node:path';
+import { createJiti } from 'jiti';
+import { glob } from 'tinyglobby';
+import { validateConfig, validateTutorial } from 'tutorial-forge';
+import { access } from 'node:fs/promises';
+const jiti = createJiti(import.meta.url, { interopDefault: true });
+const CONFIG_CANDIDATES = ['forge.config.ts', 'forge.config.mts', 'forge.config.js', 'forge.config.mjs'];
+export async function loadConfig(cwd, explicitPath) {
+    let path = explicitPath ? resolve(cwd, explicitPath) : null;
+    if (!path) {
+        for (const candidate of CONFIG_CANDIDATES) {
+            const p = resolve(cwd, candidate);
+            try {
+                await access(p);
+                path = p;
+                break;
+            }
+            catch {
+                /* try next */
+            }
+        }
+    }
+    if (!path) {
+        throw new Error(`No forge.config.{ts,js} found in ${cwd}. Create one with defineConfig() from "tutorial-forge".`);
+    }
+    const mod = await jiti.import(path);
+    const config = mod.default ?? mod;
+    return validateConfig(config);
+}
+export async function discoverTutorials(cwd, globs) {
+    const files = await glob(globs, {
+        cwd,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/dist/**', '**/.forge/**'],
+    });
+    files.sort();
+    const found = [];
+    for (const file of files) {
+        const mod = await jiti.import(file);
+        const def = mod.default ?? mod;
+        const tutorials = Array.isArray(def) ? def : [def];
+        for (const t of tutorials) {
+            if (!isTutorialLike(t)) {
+                throw new Error(`${file}: default export is not a Tutorial (need id, title, steps[])`);
+            }
+            validateTutorial(t);
+            found.push({ tutorial: t, file });
+        }
+    }
+    const ids = new Set();
+    for (const { tutorial, file } of found) {
+        if (ids.has(tutorial.id))
+            throw new Error(`Duplicate tutorial id "${tutorial.id}" (in ${file})`);
+        ids.add(tutorial.id);
+    }
+    return found;
+}
+function isTutorialLike(v) {
+    const t = v;
+    return !!t && typeof t.id === 'string' && typeof t.title === 'string' && Array.isArray(t.steps);
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { Command } from 'commander';
+import { renderCommand } from './render.js';
+import { listCommand } from './list.js';
+import { doctorCommand } from './doctor.js';
+import { cleanCommand } from './clean.js';
+// Load .env from the invocation directory so TTS keys don't need exporting.
+// Shell-set variables take precedence (loadEnvFile never overrides them).
+const envFile = join(process.cwd(), '.env');
+if (existsSync(envFile)) {
+    try {
+        process.loadEnvFile(envFile);
+    }
+    catch {
+        /* Node < 20.12 or malformed file — fall back to the shell environment */
+    }
+}
+const program = new Command('tutorial-forge')
+    .description('tutorial-forge — scripted Playwright walkthroughs to narrated tutorial videos')
+    .version('0.1.0');
+program
+    .command('render')
+    .description('render tutorials to MP4')
+    .argument('[globs...]', 'tutorial file globs (default: config or **/*.tutorial.ts)')
+    .option('--only <id>', 'render only the tutorial with this id')
+    .option('--phase <phase>', 'tts | record | post | all', 'all')
+    .option('--headed', 'show the browser while recording')
+    .option('--keep-work', 'keep the work directory on success')
+    .option('--out-dir <dir>', 'output directory (overrides config)')
+    .option('--concurrency <n>', 'TTS synthesis concurrency')
+    .option('--config <path>', 'path to forge.config.ts')
+    .action(async (globs, opts) => {
+    if (!['tts', 'record', 'post', 'all'].includes(opts.phase)) {
+        throw new Error(`Invalid --phase "${opts.phase}"`);
+    }
+    await renderCommand(globs, opts);
+});
+program
+    .command('list')
+    .description('list discovered tutorials')
+    .argument('[globs...]')
+    .option('--config <path>', 'path to forge.config.ts')
+    .action(listCommand);
+program
+    .command('doctor')
+    .description('check the environment (node, ffmpeg, playwright, TTS env vars)')
+    .action(doctorCommand);
+program
+    .command('clean')
+    .description('remove .forge/ work dirs')
+    .option('--cache', 'also clear the TTS cache')
+    .action(cleanCommand);
+program.parseAsync().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,4EAA4E;AAC5E,0EAA0E;AAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC1C,WAAW,CAAC,+EAA+E,CAAC;KAC5F,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,yBAAyB,CAAC;KACtC,QAAQ,CAAC,YAAY,EAAE,2DAA2D,CAAC;KACnF,MAAM,CAAC,aAAa,EAAE,uCAAuC,CAAC;KAC9D,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,EAAE,KAAK,CAAC;KAC7D,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC;KACtD,MAAM,CAAC,aAAa,EAAE,oCAAoC,CAAC;KAC3D,MAAM,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;KAChE,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;KACxD,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;KACpD,MAAM,CAAC,KAAK,EAAE,KAAe,EAAE,IAAI,EAAE,EAAE;IACtC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,2BAA2B,CAAC;KACxC,QAAQ,CAAC,YAAY,CAAC;KACtB,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;KACpD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC;KAC7C,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,10 @@
+export interface RenderCmdOptions {
+    only?: string;
+    phase: 'tts' | 'record' | 'post' | 'all';
+    headed?: boolean;
+    keepWork?: boolean;
+    outDir?: string;
+    concurrency?: string;
+    config?: string;
+}
+export declare function renderCommand(globs: string[], opts: RenderCmdOptions): Promise<void>;

package/dist/render.js

@@ -0,0 +1,45 @@
+import { join, resolve } from 'node:path';
+import { render } from 'tutorial-forge';
+import { loadConfig, discoverTutorials } from './load.js';
+export async function renderCommand(globs, opts) {
+    const cwd = process.cwd();
+    const config = await loadConfig(cwd, opts.config);
+    const patterns = globs.length > 0 ? globs : config.tutorials ?? ['**/*.tutorial.ts'];
+    let discovered = await discoverTutorials(cwd, patterns);
+    if (opts.only) {
+        discovered = discovered.filter((d) => d.tutorial.id === opts.only);
+        if (discovered.length === 0)
+            throw new Error(`No tutorial with id "${opts.only}" found`);
+    }
+    if (discovered.length === 0) {
+        throw new Error(`No tutorials matched ${patterns.join(', ')}`);
+    }
+    const outDir = resolve(cwd, opts.outDir ?? config.outDir ?? 'tutorials/dist');
+    for (const { tutorial } of discovered) {
+        console.log(`\n▶ ${tutorial.id} — ${tutorial.title} (${tutorial.steps.length} steps)`);
+        const result = await render(tutorial, config.adapter, {
+            tts: config.tts,
+            output: join(outDir, `${tutorial.id}.mp4`),
+            workDir: join(cwd, '.forge', tutorial.id),
+            viewport: config.viewport,
+            headless: opts.headed ? false : config.headless ?? true,
+            cursor: config.cursor,
+            callouts: config.callouts,
+            subtitles: config.subtitles,
+            leadInMs: config.leadInMs,
+            keepWorkDir: opts.keepWork ?? config.keepWorkDir,
+            ttsCacheDir: config.ttsCacheDir,
+            ttsConcurrency: opts.concurrency ? parseInt(opts.concurrency, 10) : config.ttsConcurrency,
+            phase: opts.phase,
+        });
+        if (opts.phase === 'all' || opts.phase === 'post') {
+            console.log(`✓ ${result.output} (${(result.outputDurationMs / 1000).toFixed(1)}s)`);
+            if (result.srtPath)
+                console.log(`  subtitles: ${result.srtPath}`);
+        }
+        else {
+            console.log(`✓ phase "${opts.phase}" complete — work dir: ${result.workDir}`);
+        }
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tutorial-forge-cli",
+  "version": "0.1.0",
+  "description": "CLI for tutorial-forge: render scripted Playwright walkthroughs into narrated tutorial videos",
+  "type": "module",
+  "license": "MIT",
+  "author": "John Brecht <john.brecht@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jbrecht/tutorial-forge.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/jbrecht/tutorial-forge#readme",
+  "bugs": "https://github.com/jbrecht/tutorial-forge/issues",
+  "keywords": [
+    "playwright",
+    "tutorial",
+    "video",
+    "screen-recording",
+    "tts",
+    "cli"
+  ],
+  "bin": {
+    "tutorial-forge": "./dist/main.js",
+    "tforge": "./dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^13.0.0",
+    "jiti": "^2.4.0",
+    "tinyglobby": "^0.2.10",
+    "tutorial-forge": "0.1.0"
+  },
+  "devDependencies": {
+    "playwright": "^1.59.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "echo 'no unit tests in cli'"
+  }
+}