craftdriver 0.1.0 → 0.2.0

package/dist/cli/index.js

@@ -0,0 +1,404 @@
+/**
+ * CLI entry point — `bin/craftdriver` invokes this after compile.
+ *
+ * Three modes:
+ *
+ * 1. `daemon start`   — fork into a long-running daemon process.
+ * 2. `--ephemeral`    — short-lived browser, read commands from stdin
+ *                       (one per line). Required for sandboxed cloud
+ *                       agents that can't keep a daemon between calls.
+ * 3. default          — talk to the running daemon over the socket;
+ *                       auto-start one if none is up.
+ */
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { Browser } from '../lib/browser.js';
+import { ErrorCode } from '../lib/errors.js';
+import { createBrowserHandle, dispatch } from './dispatcher.js';
+import { parseArgv, HELP_TEXT } from './parseArgs.js';
+import { DaemonClient } from './client.js';
+import { runDaemon, toWireError } from './daemon.js';
+import { DAEMON_SOCKET_PATH } from './defaults.js';
+import { runInit, SUPPORTED_FLAVORS } from './init.js';
+import { runMcpServer } from './mcp/server.js';
+const VERSION = '0.1.0';
+export async function main(argv) {
+    const parsed = parseArgv(argv);
+    if (parsed === null) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (parsed.cmd === '__version__') {
+        process.stdout.write(VERSION + '\n');
+        return 0;
+    }
+    if (parsed.flags.version) {
+        process.stdout.write(VERSION + '\n');
+        return 0;
+    }
+    if (parsed.cmd === '__help__' || parsed.flags.help) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (parsed.cmd === '__unknown__') {
+        process.stderr.write(`error: unknown command "${parsed.args.cmd}"\nrun: craftdriver --help\n`);
+        return 2;
+    }
+    applyHeadless(parsed.flags);
+    // ------------------------------------------------------------------
+    // `init <flavor>` — no browser, no daemon. Writes agent-guide files
+    // into the current project.
+    // ------------------------------------------------------------------
+    if (parsed.cmd === 'init')
+        return runInitCommand(parsed);
+    // ------------------------------------------------------------------
+    // `mcp` — long-lived JSON-RPC server on stdio. Browser is launched
+    // lazily on first tool call. No daemon involved (the MCP process is
+    // itself the long-lived session).
+    // ------------------------------------------------------------------
+    if (parsed.cmd === 'mcp') {
+        await runMcpServer({ launch: parsed.flags.launch });
+        return 0;
+    }
+    // ------------------------------------------------------------------
+    // Daemon control commands — handled in the foreground process.
+    // ------------------------------------------------------------------
+    if (parsed.cmd === 'daemon:start')
+        return daemonStart(parsed.flags);
+    if (parsed.cmd === 'daemon:stop')
+        return daemonStop(parsed);
+    if (parsed.cmd === 'daemon:status')
+        return daemonStatus(parsed);
+    if (parsed.cmd === 'daemon:run')
+        return daemonRun(parsed.flags); // internal: actual daemon process
+    // ------------------------------------------------------------------
+    // Ephemeral mode — no daemon involved.
+    // ------------------------------------------------------------------
+    if (parsed.flags.ephemeral)
+        return runEphemeral(parsed);
+    // ------------------------------------------------------------------
+    // Single command via daemon. Auto-start if needed.
+    // ------------------------------------------------------------------
+    if (!(await DaemonClient.isRunning())) {
+        const ok = await autoStartDaemon(parsed.flags);
+        if (!ok) {
+            process.stderr.write('error: could not start daemon\ncode:  DRIVER_ERROR\nhint:  try `craftdriver daemon start` to see launch errors\n');
+            return 1;
+        }
+    }
+    const client = new DaemonClient();
+    try {
+        const resp = await client.send(parsed.cmd, parsed.args);
+        return emitResponse(parsed, resp);
+    }
+    catch (e) {
+        process.stderr.write('error: ' + (e.message ?? String(e)) + '\ncode:  DRIVER_ERROR\n');
+        return 1;
+    }
+}
+function applyHeadless(flags) {
+    if (flags.headless === true)
+        process.env.HEADLESS = 'true';
+    else if (flags.headless === false)
+        process.env.HEADLESS = 'false';
+    // Default to headless on the agent surface — interactive agents rarely
+    // want a window popping up, and tests expect HEADLESS=true.
+    else if (process.env.HEADLESS === undefined)
+        process.env.HEADLESS = 'true';
+}
+// ---------------------------------------------------------------------------
+// Ephemeral mode
+// ---------------------------------------------------------------------------
+async function runEphemeral(parsed) {
+    const handle = createBrowserHandle(() => Browser.launch(parsed.flags.launch));
+    let rc = 0;
+    try {
+        if (parsed.cmd === '__stdin__') {
+            const lines = await readAllStdin();
+            for (const raw of lines.split('\n')) {
+                const line = raw.trim();
+                if (!line || line.startsWith('#'))
+                    continue;
+                const tokens = tokenize(line);
+                const sub = parseArgv(tokens);
+                if (!sub || sub.cmd.startsWith('__'))
+                    continue;
+                const result = await safeDispatch(handle, sub);
+                rc = emitInProc(sub, result) || rc;
+            }
+        }
+        else {
+            const result = await safeDispatch(handle, parsed);
+            rc = emitInProc(parsed, result);
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    return rc;
+}
+async function safeDispatch(handle, parsed) {
+    try {
+        const value = await dispatch({ handle, launchOptions: parsed.flags.launch }, parsed.cmd, parsed.args);
+        return { ok: true, value };
+    }
+    catch (e) {
+        return { ok: false, error: toWireError(e) };
+    }
+}
+function emitInProc(parsed, outcome) {
+    if (outcome.ok) {
+        writeOk(parsed, outcome.value);
+        return 0;
+    }
+    writeErr(outcome.error);
+    return exitCodeFor(outcome.error.code);
+}
+// ---------------------------------------------------------------------------
+// init
+// ---------------------------------------------------------------------------
+function runInitCommand(parsed) {
+    const flavor = String(parsed.args.flavor ?? '').toLowerCase();
+    const allowed = new Set([...SUPPORTED_FLAVORS, 'all']);
+    if (!allowed.has(flavor)) {
+        const list = [...SUPPORTED_FLAVORS, 'all'].join(' | ');
+        process.stderr.write(`error: init requires a flavor (${list})\n` +
+            `code:  INVALID_ARGUMENT\n` +
+            `hint:  example: craftdriver init copilot\n`);
+        return 2;
+    }
+    const force = parsed.args.force === true;
+    const dryRun = parsed.args['dry-run'] === true || parsed.args.dryRun === true;
+    const result = runInit({ flavor: flavor, cwd: process.cwd(), force, dryRun });
+    const prefix = dryRun ? '[dry-run] ' : '';
+    for (const p of result.written)
+        process.stdout.write(`${prefix}wrote ${p}\n`);
+    for (const p of result.skipped) {
+        process.stdout.write(`skipped ${p} (already exists; use --force to overwrite)\n`);
+    }
+    if (result.written.length === 0 && result.skipped.length > 0)
+        return 1;
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Daemon control
+// ---------------------------------------------------------------------------
+async function daemonStart(flags) {
+    if (await DaemonClient.isRunning()) {
+        const pid = DaemonClient.getPid();
+        process.stdout.write(`daemon already running (pid ${pid ?? '?'})\n`);
+        return 0;
+    }
+    const ok = await autoStartDaemon(flags);
+    if (!ok) {
+        process.stderr.write('error: failed to start daemon\n');
+        return 1;
+    }
+    const pid = DaemonClient.getPid();
+    process.stdout.write(`daemon started (pid ${pid ?? '?'}) on ${DAEMON_SOCKET_PATH}\n`);
+    return 0;
+}
+async function daemonStop(parsed) {
+    if (!(await DaemonClient.isRunning())) {
+        process.stdout.write('daemon not running\n');
+        return 0;
+    }
+    const client = new DaemonClient();
+    try {
+        await client.send('daemon:stop');
+    }
+    catch {
+        // expected — the daemon may close before flushing.
+    }
+    // Wait briefly for socket/PID cleanup.
+    for (let i = 0; i < 20; i++) {
+        if (!(await DaemonClient.isRunning()))
+            break;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    process.stdout.write('daemon stopped\n');
+    return 0;
+}
+async function daemonStatus(parsed) {
+    const running = await DaemonClient.isRunning();
+    const pid = DaemonClient.getPid();
+    if (!running) {
+        const result = { running: false, pid: null, socket: DAEMON_SOCKET_PATH };
+        writeOk(parsed, result);
+        return 0;
+    }
+    let info = { running: true, pid, socket: DAEMON_SOCKET_PATH };
+    try {
+        const client = new DaemonClient();
+        const resp = await client.send('status');
+        if (resp.ok)
+            info = { ...info, ...resp.result };
+    }
+    catch { /* ignore */ }
+    writeOk(parsed, info);
+    return 0;
+}
+async function daemonRun(flags) {
+    // Block here forever; runDaemon never resolves on success (it exits on signal).
+    await runDaemon({ launch: flags.launch });
+    return 0;
+}
+async function autoStartDaemon(flags) {
+    const self = process.argv[1] ?? fileURLToPath(import.meta.url);
+    const args = ['daemon', '__run__'];
+    if (flags.launch.browserName) {
+        args.push('--browser', flags.launch.browserName);
+    }
+    if (flags.headless === true)
+        args.push('--headless');
+    if (flags.headless === false)
+        args.push('--headed');
+    const child = spawn(process.execPath, [self, ...args], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, HEADLESS: process.env.HEADLESS ?? 'true' },
+    });
+    child.unref();
+    // Wait up to 10s for the socket to appear.
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        if (await DaemonClient.isRunning())
+            return true;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+function shouldJson(parsed) {
+    if (parsed.flags.json)
+        return true;
+    if (parsed.flags.pretty)
+        return false;
+    return !process.stdout.isTTY;
+}
+function writeOk(parsed, result) {
+    if (shouldJson(parsed)) {
+        process.stdout.write(JSON.stringify({ ok: true, result }) + '\n');
+        return;
+    }
+    // Pretty mode: small dispatcher-aware formatting for the most common cases.
+    process.stdout.write(prettyResult(parsed.cmd, result) + '\n');
+}
+function writeErr(err) {
+    // Strip the chromedriver/geckodriver stack-trace dump that comes through
+    // on transport errors. Agents read `code` and the first line of `message`;
+    // the rest is noise.
+    const cleanMessage = err.message.split('\n')[0].split('stacktrace')[0].trim();
+    if (process.stdout.isTTY) {
+        process.stderr.write(`error: ${cleanMessage}\ncode:  ${err.code}\n`);
+        if (err.hint)
+            process.stderr.write(`hint:  ${err.hint}\n`);
+        return;
+    }
+    process.stdout.write(JSON.stringify({ ok: false, error: { ...err, message: cleanMessage } }) + '\n');
+}
+function emitResponse(parsed, resp) {
+    if (resp.ok) {
+        writeOk(parsed, resp.result);
+        // `exists` is a probe: exit 1 when nothing matched, even though
+        // the call itself succeeded. Agents script around the exit code.
+        if (parsed.cmd === 'exists') {
+            const r = resp.result;
+            if (r && r.exists === false)
+                return 1;
+        }
+        return 0;
+    }
+    writeErr(resp.error);
+    return exitCodeFor(resp.error.code);
+}
+function exitCodeFor(code) {
+    if (code === ErrorCode.INVALID_ARGUMENT)
+        return 2;
+    return 1;
+}
+function prettyResult(cmd, result) {
+    if (result === null || result === undefined)
+        return '';
+    if (typeof result === 'string')
+        return result;
+    if (typeof result === 'number' || typeof result === 'boolean')
+        return String(result);
+    const r = result;
+    if (cmd === 'find' && Array.isArray(r.matches)) {
+        const lines = r.matches.map((m, i) => {
+            const idx = m.index ?? i;
+            const tag = m.tag ?? '';
+            const text = m.text ?? '';
+            const vis = m.visible ? '' : ' (hidden)';
+            return `[${idx}] <${tag}>${vis}  "${text}"`;
+        });
+        const header = `count=${r.count}${r.truncated ? ' (truncated)' : ''}`;
+        const trailer = r.truncated && r.total !== undefined && r.next_offset !== undefined && r.next_offset !== null
+            ? `\n... ${r.total} total; resume with --offset ${r.next_offset}`
+            : '';
+        return [header, ...lines].join('\n') + trailer;
+    }
+    if (cmd === 'pages' && Array.isArray(r.pages)) {
+        return r.pages
+            .map((p, i) => `[${i}] ${p.url ?? ''}  —  ${p.title ?? ''}`)
+            .join('\n');
+    }
+    if (cmd === 'snapshot' && Array.isArray(r.lines)) {
+        const header = `page: ${r.title || '(untitled)'} — ${r.url || '(no url)'}`;
+        const lines = r.lines;
+        if (lines.length === 0)
+            return `${header}\n(no interactive elements detected)`;
+        return `${header}\n${lines.join('\n')}`;
+    }
+    return JSON.stringify(result, null, 2);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function tokenize(line) {
+    // Minimal shell-like tokeniser: supports single/double quotes.
+    const out = [];
+    let cur = '';
+    let quote = null;
+    for (const ch of line) {
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+                continue;
+            }
+            cur += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (ch === ' ' || ch === '\t') {
+            if (cur) {
+                out.push(cur);
+                cur = '';
+            }
+            continue;
+        }
+        cur += ch;
+    }
+    if (cur)
+        out.push(cur);
+    return out;
+}
+async function readAllStdin() {
+    return new Promise((resolve) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (c) => { buf += c; });
+        process.stdin.on('end', () => resolve(buf));
+    });
+}
+// Handle the internal "daemon __run__" invocation used by autoStartDaemon.
+// Map sub-token "__run__" → "run" so parseArgv produces `daemon:run`.
+if (process.argv[3] === '__run__')
+    process.argv[3] = 'run';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,24 @@
+export type Flavor = 'agents' | 'copilot' | 'claude' | 'cursor' | 'gemini' | 'all';
+export declare const SUPPORTED_FLAVORS: ReadonlyArray<Exclude<Flavor, 'all'>>;
+/** Single source of truth for the body each adapter writes. */
+export declare function buildBody(): string;
+export interface InitResult {
+    /** Files actually written (or that would be written, in dry-run mode). */
+    written: string[];
+    /** Files that already existed and were skipped (no --force). */
+    skipped: string[];
+    /** When true, no files were touched on disk. */
+    dryRun: boolean;
+}
+export interface InitOptions {
+    flavor: Flavor;
+    cwd: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Resolve the flavor list, render the body once, and write each target.
+ * Returns the list of paths so the caller can print a summary.
+ */
+export declare function runInit(opts: InitOptions): InitResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnF,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAMnE,CAAC;AAwCF,+DAA+D;AAC/D,wBAAgB,SAAS,IAAI,MAAM,CAkHlC;AAED,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAyBrD"}

package/dist/cli/init.js

@@ -0,0 +1,192 @@
+/**
+ * `craftdriver init <flavor>` — write an agent-guide file into the
+ * current project. Each flavor maps to one or more well-known paths
+ * that a specific AI assistant reads on every turn.
+ *
+ * One body of text, N filenames. Adapters can prepend a flavor-specific
+ * header (e.g. Cursor's `.mdc` frontmatter) but the rules below the
+ * header are identical across flavors so every agent on a team gets the
+ * same instructions.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { dirname, join, relative } from 'path';
+export const SUPPORTED_FLAVORS = [
+    'agents',
+    'copilot',
+    'claude',
+    'cursor',
+    'gemini',
+];
+/**
+ * Map a flavor to the paths it writes, relative to the project root.
+ * Keep this small and conventional — anything more specific belongs in
+ * each tool's own docs.
+ */
+function targetsFor(flavor) {
+    switch (flavor) {
+        case 'agents':
+            // AGENTS.md is the cross-tool convention picked up by Codex,
+            // OpenCode, Aider, Amp, and also Cursor.
+            return [{ path: 'AGENTS.md' }];
+        case 'copilot':
+            return [{ path: '.github/copilot-instructions.md' }];
+        case 'claude':
+            return [{ path: 'CLAUDE.md' }];
+        case 'cursor':
+            return [
+                {
+                    path: '.cursor/rules/craftdriver.mdc',
+                    header: '---\n' +
+                        'description: craftdriver — agent rules for browser automation tests\n' +
+                        'globs: ["**/*.{ts,tsx,js,jsx}"]\n' +
+                        'alwaysApply: true\n' +
+                        '---\n\n',
+                },
+            ];
+        case 'gemini':
+            return [{ path: 'GEMINI.md' }];
+    }
+}
+/** Single source of truth for the body each adapter writes. */
+export function buildBody() {
+    return `# Working with craftdriver
+
+This project uses [craftdriver](https://www.npmjs.com/package/craftdriver),
+a BiDi-first WebDriver library for Node.js. Follow these rules whenever
+you write or modify browser-automation code in this repo.
+
+## Use craftdriver, not raw Selenium or Playwright
+
+\`\`\`ts
+import { Browser, By, expect } from 'craftdriver';
+
+const browser = await Browser.launch({ browserName: 'chrome' });
+await browser.navigateTo('https://example.com/login');
+await browser.fill('#username', 'alice');
+await browser.click('button[type=submit]');
+await expect(browser.locator('#welcome')).toHaveText(/welcome/i);
+await browser.quit();
+\`\`\`
+
+The public surface is whatever \`src/index.ts\` of \`craftdriver\` re-exports.
+Anything under \`craftdriver/src/lib/\` is internal — do not import it.
+
+## Selector preference order
+
+Prefer stable, semantic locators. They survive DOM refactors; CSS and
+XPath break the moment markup shifts.
+
+\`\`\`
+By.testId  >  By.role({ name })  >  By.labelText  >
+By.text({ exact: true })  >  By.css  >  By.xpath
+\`\`\`
+
+String selectors passed directly to \`browser.click('…')\` etc. are
+treated as CSS. Use \`By.*\` helpers or \`browser.getBy*()\` when you
+want a semantic locator.
+
+## Auto-waiting — do not add sleeps
+
+Every action and every \`expect(locator).to…()\` already waits up to the
+default timeout (30 s in-library, 5 s on the CLI). **Never** add
+\`setTimeout\`, \`sleep\`, or hand-rolled \`while (…) { … }\` retry loops.
+They are footguns: actions wait for the right condition; sleeps wait
+for the wrong amount of time.
+
+\`\`\`ts
+// Good
+await expect(browser.locator('#status')).toHaveText('Ready');
+
+// Bad
+await new Promise(r => setTimeout(r, 2000));
+expect(await browser.text('#status')).toBe('Ready');
+\`\`\`
+
+## Errors carry a stable \`code\`
+
+Every error thrown by the public API is a \`CraftdriverError\` with a
+stable \`code\` field. Match on the code, not the prose:
+
+\`\`\`ts
+import { CraftdriverError, ErrorCode } from 'craftdriver';
+
+try {
+  await browser.click('#submit');
+} catch (e) {
+  if (e instanceof CraftdriverError && e.code === ErrorCode.NO_MATCH) {
+    // selector matched zero elements — fix the selector
+  }
+}
+\`\`\`
+
+Common codes: \`NO_MATCH\`, \`TIMEOUT_WAITING_VISIBLE\`,
+\`TIMEOUT_WAITING_STATE\`, \`TIMEOUT_WAITING_LOAD\`, \`EXPECT_MISMATCH\`,
+\`INVALID_ARGUMENT\`, \`UNSUPPORTED\`. Full list in
+\`node_modules/craftdriver/docs/error-codes.md\`.
+
+## CLI for exploration and agent loops
+
+For ad-hoc probing from a shell — including agent-driven loops —
+craftdriver ships a \`craftdriver\` binary:
+
+\`\`\`bash
+npx craftdriver daemon start
+npx craftdriver go http://127.0.0.1:8080/login.html
+npx craftdriver exists '#submit'        # 0-wait probe; exit 0 = match
+npx craftdriver fill '#username' alice
+npx craftdriver click 'button[type=submit]'
+npx craftdriver text '#welcome'
+npx craftdriver daemon stop
+\`\`\`
+
+Selectors are CSS by default; switch with \`prefix=value\`
+(\`role=button[name=Submit]\`, \`text=Sign In\`, \`label=Email\`,
+\`testid=login-btn\`, \`xpath=…\`). Exit codes: \`0\` success,
+\`1\` assertion/timeout/no-match, \`2\` usage error.
+
+Probe before acting on a guess: \`craftdriver exists …\` is a 0-wait
+check that returns immediately. Don't \`click\` a hallucinated selector
+and burn the full timeout.
+
+Full reference: \`node_modules/craftdriver/docs/cli.md\`.
+
+## Pointers
+
+- \`node_modules/craftdriver/docs/api-reference.md\` — every public
+  symbol, one row each. Read this before inventing a method.
+- \`node_modules/craftdriver/docs/error-codes.md\` — every error code,
+  when it fires, recommended recovery.
+- \`node_modules/craftdriver/docs/cli.md\` — full CLI reference.
+- \`node_modules/craftdriver/skills/craftdriver/\` — agent-facing SKILL
+  pack: \`SKILL.md\` (always-on rules), \`cheatsheet.md\` (writing tests),
+  \`patterns.md\` (login/upload/network-wait recipes), \`cli.md\` (CLI from
+  an agent's POV).
+`;
+}
+/**
+ * Resolve the flavor list, render the body once, and write each target.
+ * Returns the list of paths so the caller can print a summary.
+ */
+export function runInit(opts) {
+    const flavors = opts.flavor === 'all' ? [...SUPPORTED_FLAVORS] : [opts.flavor];
+    const body = buildBody();
+    const written = [];
+    const skipped = [];
+    for (const flavor of flavors) {
+        for (const target of targetsFor(flavor)) {
+            const abs = join(opts.cwd, target.path);
+            if (existsSync(abs) && !opts.force) {
+                skipped.push(relative(opts.cwd, abs));
+                continue;
+            }
+            const content = (target.header ?? '') + body;
+            if (!opts.dryRun) {
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, content, 'utf8');
+            }
+            written.push(relative(opts.cwd, abs));
+        }
+    }
+    return { written, skipped, dryRun: opts.dryRun === true };
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAI/C,MAAM,CAAC,MAAM,iBAAiB,GAA0C;IACtE,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAC;AAQF;;;;GAIG;AACH,SAAS,UAAU,CAAC,MAA8B;IAChD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,6DAA6D;YAC7D,yCAAyC;YACzC,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;QACvD,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACjC,KAAK,QAAQ;YACX,OAAO;gBACL;oBACE,IAAI,EAAE,+BAA+B;oBACrC,MAAM,EACJ,OAAO;wBACP,uEAAuE;wBACvE,mCAAmC;wBACnC,qBAAqB;wBACrB,SAAS;iBACZ;aACF,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS;IACvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHR,CAAC;AACF,CAAC;AAkBD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAiB;IACvC,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;gBACtC,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7C,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;AAC5D,CAAC"}