@tracelane/cli 0.1.0-alpha.1

package/NOTICE

@@ -0,0 +1,11 @@
+rrweb-stack
+Copyright 2026 Cubenest
+
+@tracelane/cli — the `tracelane` scaffolding CLI. Detects the user's test runner
+and wires @tracelane/wdio into wdio.conf.* in a single `npx tracelane init`
+invocation. Pure Node; no third-party runtime dependencies (uses only
+node:* primitives for argv parsing, file I/O, prompts, and the package-manager
+install spawn).
+
+This product is licensed under the Apache License, Version 2.0.
+See the LICENSE file for details.

package/README.md

@@ -0,0 +1,104 @@
+# @tracelane/cli
+
+> One command to wire tracelane into your WebdriverIO project. Detects your runner + package manager, installs `@tracelane/wdio`, edits `wdio.conf.ts`, creates `tracelane-reports/`, ignores it in git. Idempotent and dry-runnable.
+
+[![npm](https://img.shields.io/npm/v/@tracelane/cli.svg)](https://www.npmjs.com/package/@tracelane/cli)
+[![downloads](https://img.shields.io/npm/dw/@tracelane/cli.svg)](https://www.npmjs.com/package/@tracelane/cli)
+[![license](https://img.shields.io/npm/l/@tracelane/cli.svg)](https://github.com/Cubenest/rrweb-stack/blob/main/LICENSE)
+[![CI](https://github.com/Cubenest/rrweb-stack/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Cubenest/rrweb-stack/actions/workflows/ci.yml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Cubenest/rrweb-stack/badge)](https://scorecard.dev/viewer/?uri=github.com/Cubenest/rrweb-stack)
+
+```sh
+cd your-wdio-project
+npx tracelane init
+```
+
+That's it. `npx tracelane init` does four things:
+
+1. Detects WebdriverIO from `wdio.conf.{ts,js,mjs,cjs}` and your package manager from your lockfile.
+2. Runs the package manager's dev-add for `@tracelane/wdio` (`pnpm add -D` / `yarn add -D` / `npm install --save-dev` / `bun add -d`).
+3. Edits `wdio.conf.ts` in place: adds the `TraceLaneService` import and inserts the service tuple into the `services:` array.
+4. Creates `./tracelane-reports/` and appends `tracelane-reports/` to `.gitignore`.
+
+Run your tests. On a failing Chrome test you get `./tracelane-reports/<spec>--<title>.html` — open it in any browser, replay the run with [rrweb-player](https://www.rrweb.io), inspect console + failed-network panels, attach to any bug tracker.
+
+See the [@tracelane/wdio README](https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-wdio) for the full options reference.
+
+## Usage
+
+```
+npx tracelane init [options]
+
+Options:
+  --runner <name>      Force runner choice (wdio|playwright|cypress).
+                       Default: auto-detected from project files.
+  --dry-run            Print what would happen; change nothing.
+  --yes, -y            Skip the "about to do X, Y, Z - continue?" prompt.
+  --skip-install       Don't run the package-manager install command.
+                       Useful if you have @tracelane/wdio already.
+  --help, -h           Show usage.
+```
+
+`--dry-run` prints exactly the steps the run would take (and the conf-edit preview) without modifying anything. Re-running `init` against an already-wired conf is a no-op (idempotent).
+
+## What this is NOT
+
+- Not a test runner. tracelane wires itself **into** WebdriverIO; you keep using `npx wdio run wdio.conf.ts` (or whatever runner you have today).
+- Not a SaaS or cloud uploader. The artifact is a single HTML file on your filesystem.
+- Not coupled to the GitHub repo. The CLI only reads + writes files in the directory you ran it from.
+
+## Playwright and Cypress
+
+Detection works, but the v0.1 CLI exits 0 with a "coming Q3/Q4 2026" message for these. The integration packages (`@tracelane/playwright`, `@tracelane/cypress`) aren't published yet — when they are, a future bump to `@tracelane/cli` will add the wiring. Track:
+
+- Playwright: [issue #11](https://github.com/Cubenest/rrweb-stack/issues/11) — target Q3 2026
+- Cypress: [issue #12](https://github.com/Cubenest/rrweb-stack/issues/12) — target Q4 2026
+
+If you have a `wdio.conf.*` alongside a Playwright/Cypress conf, the WDIO path wins by default — pass `--runner playwright` or `--runner cypress` to override (it'll still print the coming-soon message).
+
+## How the conf edit works (and what to do if it fails)
+
+The editor uses string-based regex to:
+
+1. Insert `import TraceLaneService from '@tracelane/wdio';` after the last existing `import` line.
+2. Append `[TraceLaneService, { mode: 'failed' }]` as the LAST element of the `services:` array. Three shapes are recognized:
+   - `services: []` (empty)
+   - `services: ['devtools']` (string elements)
+   - `services: [['devtools', {}]]` (tuple elements, including multi-line)
+3. If no `services:` key exists, insert one at the end of the config object literal.
+
+If the regex doesn't recognize the conf shape (exotic formatting, dynamically constructed config, etc.) the editor **backs out cleanly** — your conf is NEVER corrupted — and prints the snippet to paste manually. The rest of `init` (install, reports dir, .gitignore) still runs.
+
+A backup `wdio.conf.ts.tracelane-init.backup` is written before the edit; on success it's deleted. On the rare post-write sanity-check failure, the original is restored from the backup and the `.backup` is left next to your conf for one-shot inspection.
+
+## Manual install path
+
+If you prefer to wire by hand (e.g. CI scripts, custom configs):
+
+```sh
+npm install --save-dev @tracelane/wdio
+mkdir -p tracelane-reports
+echo "tracelane-reports/" >> .gitignore
+```
+
+```ts
+// wdio.conf.ts
+import TraceLaneService from '@tracelane/wdio';
+
+export const config = {
+  // ...your existing config
+  services: [[TraceLaneService, { mode: 'failed' }]],
+};
+```
+
+Both routes produce the same setup. The CLI exists to remove the "edit wdio.conf.ts" step from the README install instructions.
+
+## Versioning + telemetry
+
+Semantic Versioning. Currently `0.1.0-alpha.x` (pre-release; the API + flags may shift before `1.0.0`).
+
+**No telemetry.** The CLI inspects local files only (lockfile presence, conf shape) and spawns the package-manager process you'd have run by hand. Nothing is sent anywhere.
+
+## License
+
+Apache 2.0. Contributions accepted under the [Developer Certificate of Origin (DCO)](https://developercertificate.org/) — sign commits with `git commit -s`. See [CONTRIBUTING.md](https://github.com/Cubenest/rrweb-stack/blob/main/CONTRIBUTING.md) + [SECURITY.md](https://github.com/Cubenest/rrweb-stack/blob/main/SECURITY.md).

package/dist/commands/init.d.ts

@@ -0,0 +1,44 @@
+import { type SpawnSyncReturns } from 'node:child_process';
+import { type Runner } from '../lib/detect.js';
+/** Spawn-sync signature, narrowed to what we need + injectable for tests. */
+export type SpawnRunner = (program: string, args: readonly string[], options: {
+    cwd: string;
+    stdio: 'inherit' | 'pipe';
+    env?: NodeJS.ProcessEnv;
+}) => SpawnSyncReturns<Buffer>;
+/** Options accepted by the testable `runInitProgrammatic` entrypoint. */
+export interface InitOptions {
+    /** Project root the CLI was invoked in (process.cwd() for production). */
+    readonly cwd: string;
+    /** User-passed --runner override; undefined → auto-detect. */
+    readonly runner?: Runner | undefined;
+    /** --dry-run: print but don't modify anything. */
+    readonly dryRun?: boolean;
+    /** --yes: skip the confirmation prompt. */
+    readonly yes?: boolean;
+    /** --skip-install: don't run the package-manager install. */
+    readonly skipInstall?: boolean;
+    /** Where to write stdout (defaults to process.stdout). */
+    readonly stdout?: NodeJS.WritableStream;
+    /** Where to write stderr (defaults to process.stderr). */
+    readonly stderr?: NodeJS.WritableStream;
+    /** Override the spawn function (tests stub this so we don't hit npm). */
+    readonly spawn?: SpawnRunner;
+}
+/**
+ * The pure-ish programmatic entrypoint. Tests call this directly with a
+ * fake cwd + fake spawn; the bin shell calls `runInit(argv)` which forwards
+ * to here with process.cwd() + the real spawn.
+ *
+ * Returns the process exit code (0 = success / coming-soon, 1 = nothing
+ * matched or a hard error).
+ */
+export declare function runInitProgrammatic(opts: InitOptions): Promise<number>;
+/** Help text for `tracelane init --help`. */
+export declare const INIT_HELP = "tracelane init - wire @tracelane/wdio into the project in this directory.\n\nUsage: npx tracelane init [options]\n\nOptions:\n  --runner <name>      Force runner choice (wdio|playwright|cypress).\n                       Default: auto-detected from project files.\n  --dry-run            Print what would happen; change nothing.\n  --yes, -y            Skip the \"about to do X, Y, Z - continue?\" prompt.\n  --skip-install       Don't run the package-manager install command.\n                       Useful if you have @tracelane/wdio already.\n  --help, -h           Show this help.\n\nThe CLI scans the current working directory for a wdio.conf.{ts,js,mjs,cjs},\nadds @tracelane/wdio as a devDependency via the detected package manager\n(pnpm/yarn/npm/bun), inserts the import + service tuple into the conf, creates\n./tracelane-reports/, and appends to .gitignore. Idempotent: re-running on an\nalready-wired project is a no-op.\n\nAuto-edit limitation: the conf editor uses string regex to insert into the\nservices array. If it can't recognise the array shape it BACKS OUT cleanly\nand prints the snippet to paste manually - it will NEVER corrupt your conf.\n";
+/**
+ * Argv entry for `tracelane init`. Parses flags via node:util.parseArgs and
+ * delegates to runInitProgrammatic.
+ */
+export declare function runInit(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,oBAAoB,CAAC;AAWtE,OAAO,EAGL,KAAK,MAAM,EAKZ,MAAM,kBAAkB,CAAC;AAa1B,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KACzE,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAK9B,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACxC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B;AAkFD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA+L5E;AAuFD,6CAA6C;AAC7C,eAAO,MAAM,SAAS,ipCAsBrB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDtE"}

package/dist/commands/init.js

@@ -0,0 +1,383 @@
+// `tracelane init` — the wedge amplifier. One npx invocation replaces the
+// previous "npm install + manually edit wdio.conf.ts" two-step.
+//
+// Steps:
+//   1. Detect runner (or honour --runner) in process.cwd().
+//   2. Detect package manager from lockfile presence.
+//   3. For WDIO: ask, then install @tracelane/wdio + edit conf + mkdir
+//      ./tracelane-reports/ + append to .gitignore.
+//   4. For Playwright/Cypress: print "support coming Q3/Q4 2026" + a tracking
+//      issue link, install nothing, exit 0.
+//
+// Side effects (mkdirSync, writeFileSync, the package-manager spawn) are
+// gated behind --dry-run and an interactive confirm prompt (suppressed by
+// --yes). The package-manager spawn is injectable so tests don't hit the
+// real npm registry.
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { parseArgs } from 'node:util';
+import { detectPackageManager, detectRunner, findRunnerConfig, installCommand, } from '../lib/detect.js';
+import { hasTracelaneEntry, mergeGitignore } from '../lib/gitignore.js';
+import { confirm } from '../lib/prompt.js';
+import { MANUAL_SNIPPET, applyWdioEdit } from '../lib/wdio-editor.js';
+/** Tracking-issue URLs for the not-yet-shipped Playwright/Cypress paths. */
+// NOTE for maintainer: these issue numbers don't have to exist on day one —
+// `tracelane init` is exiting 0 either way. File them before announcement so
+// the URL resolves to a real tracking issue instead of a 404. (#11 = Playwright,
+// #12 = Cypress per the wedge-amplifier spec.)
+const PLAYWRIGHT_ISSUE = 'https://github.com/Cubenest/rrweb-stack/issues/11';
+const CYPRESS_ISSUE = 'https://github.com/Cubenest/rrweb-stack/issues/12';
+const realSpawn = (program, args, options) => spawnSync(program, args, options);
+/** Wrap process.stdout.write so we can swap in a fake in tests. */
+function write(s, msg) {
+    (s ?? process.stdout).write(msg);
+}
+/** Stderr variant. */
+function writeErr(s, msg) {
+    (s ?? process.stderr).write(msg);
+}
+/** Pretty-print the package-manager install command for the user. */
+function commandString(cmd) {
+    return cmd.join(' ');
+}
+function describeSteps(detected, pm, options) {
+    const steps = [];
+    let i = 1;
+    if (!options.skipInstall) {
+        steps.push({
+            index: i++,
+            description: commandString(installCommand(pm.manager)),
+        });
+    }
+    steps.push({
+        index: i++,
+        description: `Edit ${basename(detected.configPath)} to register the Service`,
+    });
+    steps.push({ index: i++, description: 'Create ./tracelane-reports/' });
+    steps.push({
+        index: i++,
+        description: options.gitignoreExists
+            ? 'Append tracelane-reports/ to .gitignore'
+            : 'Create .gitignore with tracelane-reports/',
+    });
+    return steps;
+}
+/** node:path.basename without the import — we only need it for log lines. */
+function basename(p) {
+    return p.split(/[/\\]/).pop() ?? p;
+}
+/**
+ * Print the not-yet-supported message for Playwright / Cypress. Exits 0
+ * (no error — the user has a valid project, we just don't have wiring yet).
+ */
+function printComingSoon(detected, stdout) {
+    const runnerLabel = detected.runner === 'playwright' ? 'Playwright' : 'Cypress';
+    const target = detected.runner === 'playwright' ? 'Q3 2026' : 'Q4 2026';
+    const issue = detected.runner === 'playwright' ? PLAYWRIGHT_ISSUE : CYPRESS_ISSUE;
+    write(stdout, [
+        `tracelane init - detected ${runnerLabel} project (${basename(detected.configPath)}).`,
+        '',
+        `tracelane ${runnerLabel} support is in development; target ship ${target}.`,
+        `Track: ${issue}`,
+        '',
+        'To use tracelane today, add a WebdriverIO suite, or pass --runner wdio',
+        'if your project already has a wdio.conf.*.',
+        '',
+    ].join('\n'));
+    return 0;
+}
+/**
+ * The pure-ish programmatic entrypoint. Tests call this directly with a
+ * fake cwd + fake spawn; the bin shell calls `runInit(argv)` which forwards
+ * to here with process.cwd() + the real spawn.
+ *
+ * Returns the process exit code (0 = success / coming-soon, 1 = nothing
+ * matched or a hard error).
+ */
+export async function runInitProgrammatic(opts) {
+    const stdout = opts.stdout;
+    const stderr = opts.stderr;
+    const spawn = opts.spawn ?? realSpawn;
+    const cwd = opts.cwd;
+    // ---- Runner resolution -------------------------------------------------
+    let detected;
+    if (opts.runner !== undefined) {
+        // --runner forces the choice; we still try to find a config file so the
+        // editor has something to point at.
+        const configPath = findRunnerConfig(cwd, opts.runner);
+        if (configPath === undefined) {
+            // For WDIO we need a config file. For Playwright/Cypress the no-op
+            // print doesn't strictly need one — but the user asked us to pretend,
+            // so be explicit.
+            writeErr(stderr, `tracelane init: --runner ${opts.runner} was passed, but no matching config file found in ${cwd}.\n`);
+            return 1;
+        }
+        detected = { runner: opts.runner, configPath };
+    }
+    else {
+        detected = detectRunner(cwd);
+        if (detected === undefined) {
+            writeErr(stderr, `tracelane init: No supported test runner detected in ${cwd}. Run from your project root, or pass \`--runner wdio\` explicitly.\n`);
+            return 1;
+        }
+    }
+    // ---- Runner-specific routing ------------------------------------------
+    if (detected.runner !== 'wdio') {
+        return printComingSoon(detected, stdout);
+    }
+    // ---- WDIO happy path --------------------------------------------------
+    const pm = detectPackageManager(cwd);
+    const gitignorePath = join(cwd, '.gitignore');
+    const gitignoreExists = existsSync(gitignorePath);
+    const skipInstall = opts.skipInstall ?? false;
+    write(stdout, `tracelane init - detected WebdriverIO project (${basename(detected.configPath)}) using ${pm.manager}.\n\n`);
+    if (pm.multipleLockfiles) {
+        write(stdout, `Note: multiple lockfiles detected (${pm.lockfilesFound.join(', ')}); using ${pm.manager}.\n\n`);
+    }
+    if (pm.fallback) {
+        write(stdout, 'Note: no lockfile detected; defaulting to npm.\n\n');
+    }
+    const steps = describeSteps(detected, pm, { skipInstall, gitignoreExists });
+    write(stdout, opts.dryRun ? 'DRY RUN — would do:\n' : 'About to:\n');
+    for (const s of steps) {
+        write(stdout, `  ${s.index}. ${opts.dryRun ? 'WOULD: ' : ''}${s.description}\n`);
+    }
+    write(stdout, '\n');
+    if (opts.dryRun) {
+        // Show the conf-edit preview without writing.
+        const preview = previewConfEdit(detected.configPath);
+        if (preview !== undefined)
+            write(stdout, preview);
+        write(stdout, 'Dry run complete; no files changed.\n');
+        return 0;
+    }
+    if (!opts.yes) {
+        const proceed = await confirm('Continue?', true);
+        if (!proceed) {
+            write(stdout, 'Aborted.\n');
+            return 0;
+        }
+    }
+    // ---- Execute the steps ------------------------------------------------
+    if (!skipInstall) {
+        const cmd = installCommand(pm.manager);
+        const [program, ...args] = cmd;
+        if (program === undefined) {
+            writeErr(stderr, 'tracelane init: empty install command (internal error).\n');
+            return 1;
+        }
+        write(stdout, `Running: ${commandString(cmd)}\n`);
+        const result = spawn(program, args, { cwd, stdio: 'inherit' });
+        if (result.error) {
+            writeErr(stderr, `tracelane init: install failed to launch: ${result.error.message}\n`);
+            return 1;
+        }
+        if (result.status !== 0) {
+            writeErr(stderr, `tracelane init: install exited with code ${result.status}. Re-run with --skip-install once you've added @tracelane/wdio manually.\n`);
+            return 1;
+        }
+        write(stdout, '\n');
+    }
+    // Edit the wdio.conf.* in place. Back-out path keeps a one-shot .backup
+    // next to the conf so the user can restore on their own if anything
+    // looks wrong after the run.
+    const editOutcome = editWdioConfOnDisk(detected.configPath);
+    if (editOutcome.kind === 'manual') {
+        write(stdout, [
+            `! Could not auto-edit ${basename(detected.configPath)}: ${editOutcome.reason}`,
+            '  Paste the following into your conf manually:',
+            '',
+            ...editOutcome.snippet.split('\n').map((l) => `    ${l}`),
+            '',
+            '  The rest of init (reports dir + .gitignore) still ran.',
+            '',
+        ].join('\n'));
+    }
+    else if (editOutcome.kind === 'restored') {
+        write(stdout, [
+            `! Auto-edit of ${basename(detected.configPath)} failed sanity check; original restored.`,
+            `  Backup kept at ${basename(editOutcome.backupPath)} for one-shot recovery.`,
+            '  Paste the following manually:',
+            '',
+            ...editOutcome.snippet.split('\n').map((l) => `    ${l}`),
+            '',
+        ].join('\n'));
+    }
+    else if (editOutcome.kind === 'alreadyConfigured') {
+        write(stdout, `* ${basename(detected.configPath)} already wires TraceLaneService; left it alone.\n`);
+    }
+    else {
+        write(stdout, `+ Edited ${basename(detected.configPath)}.\n`);
+    }
+    // mkdir is idempotent with `recursive: true`.
+    const reportsDir = join(cwd, 'tracelane-reports');
+    mkdirSync(reportsDir, { recursive: true });
+    write(stdout, '+ Created ./tracelane-reports/\n');
+    // .gitignore: read-modify-write iff our entry isn't already there.
+    let gitignoreExisting = '';
+    if (existsSync(gitignorePath)) {
+        gitignoreExisting = readFileSync(gitignorePath, 'utf8');
+    }
+    if (hasTracelaneEntry(gitignoreExisting)) {
+        write(stdout, '* .gitignore already lists tracelane-reports/; left it alone.\n');
+    }
+    else {
+        const merged = mergeGitignore(gitignoreExisting);
+        writeFileSync(gitignorePath, merged, 'utf8');
+        write(stdout, gitignoreExisting.length === 0
+            ? '+ Created .gitignore with tracelane-reports/\n'
+            : '+ Appended tracelane-reports/ to .gitignore\n');
+    }
+    // Final message — the "next: " call to action. Include a literal,
+    // copy-paste-ready command so the user knows exactly what to run, with
+    // the conf filename matching what we detected (handles .js/.mjs/.cjs).
+    const ok = process.stdout.isTTY ? '✔' : 'OK';
+    write(stdout, [
+        '',
+        `${ok} done.`,
+        `Run: npx wdio run ${basename(detected.configPath)}`,
+        'On a failing Chrome test you get',
+        './tracelane-reports/<spec>--<title>.html — open it in any browser.',
+        '',
+        'Docs: https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-wdio',
+        '',
+    ].join('\n'));
+    return 0;
+}
+function editWdioConfOnDisk(configPath) {
+    const original = readFileSync(configPath, 'utf8');
+    const result = applyWdioEdit(original);
+    if (!result.ok) {
+        // Pure-function back-out: the editor never touched anything; just report.
+        return { kind: 'manual', reason: result.reason, snippet: result.manualSnippet };
+    }
+    if (result.alreadyConfigured) {
+        return { kind: 'alreadyConfigured' };
+    }
+    // Belt-and-braces: persist the original to a .backup before overwriting,
+    // then sanity-check what we wrote by reading it back. If the read-back
+    // doesn't match what we expected, restore.
+    const backupPath = `${configPath}.tracelane-init.backup`;
+    writeFileSync(backupPath, original, 'utf8');
+    writeFileSync(configPath, result.source, 'utf8');
+    const verifyContent = readFileSync(configPath, 'utf8');
+    if (verifyContent !== result.source) {
+        // Disk corruption is exceedingly unlikely but we'd rather catch it.
+        renameSync(backupPath, configPath);
+        return {
+            kind: 'restored',
+            reason: 'post-write read-back did not match expected content',
+            // Single source of truth — defined alongside the editor's back-out
+            // path so the snippet copy can't drift.
+            snippet: MANUAL_SNIPPET,
+            backupPath,
+        };
+    }
+    // Edit succeeded; clean up the backup since the live file is good.
+    try {
+        unlinkSync(backupPath);
+    }
+    catch {
+        // Non-fatal; the leftover .backup is harmless.
+    }
+    return { kind: 'edited' };
+}
+/** Build the WOULD-BE diff preview shown by --dry-run. */
+function previewConfEdit(configPath) {
+    let original;
+    try {
+        original = readFileSync(configPath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    const result = applyWdioEdit(original);
+    if (!result.ok) {
+        return `Would back out of conf edit: ${result.reason}\n  Manual snippet:\n${result.manualSnippet
+            .split('\n')
+            .map((l) => `    ${l}`)
+            .join('\n')}\n\n`;
+    }
+    if (result.alreadyConfigured) {
+        return `Would leave ${basename(configPath)} alone (already wires TraceLaneService).\n\n`;
+    }
+    // Show a compact summary of what would change instead of a full diff —
+    // the byte delta is small and the user can diff themselves if they want.
+    const importLine = result.addedImport
+        ? "+ import TraceLaneService from '@tracelane/wdio';\n"
+        : '';
+    const entryLine = result.addedServiceEntry
+        ? "+ services: [..., [TraceLaneService, { mode: 'failed' }]]\n"
+        : '';
+    return `Conf edit preview (${basename(configPath)}):\n${importLine}${entryLine}\n`;
+}
+/** Help text for `tracelane init --help`. */
+export const INIT_HELP = `tracelane init - wire @tracelane/wdio into the project in this directory.
+
+Usage: npx tracelane init [options]
+
+Options:
+  --runner <name>      Force runner choice (wdio|playwright|cypress).
+                       Default: auto-detected from project files.
+  --dry-run            Print what would happen; change nothing.
+  --yes, -y            Skip the "about to do X, Y, Z - continue?" prompt.
+  --skip-install       Don't run the package-manager install command.
+                       Useful if you have @tracelane/wdio already.
+  --help, -h           Show this help.
+
+The CLI scans the current working directory for a wdio.conf.{ts,js,mjs,cjs},
+adds @tracelane/wdio as a devDependency via the detected package manager
+(pnpm/yarn/npm/bun), inserts the import + service tuple into the conf, creates
+./tracelane-reports/, and appends to .gitignore. Idempotent: re-running on an
+already-wired project is a no-op.
+
+Auto-edit limitation: the conf editor uses string regex to insert into the
+services array. If it can't recognise the array shape it BACKS OUT cleanly
+and prints the snippet to paste manually - it will NEVER corrupt your conf.
+`;
+/**
+ * Argv entry for `tracelane init`. Parses flags via node:util.parseArgs and
+ * delegates to runInitProgrammatic.
+ */
+export async function runInit(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...argv],
+            options: {
+                runner: { type: 'string' },
+                'dry-run': { type: 'boolean' },
+                yes: { type: 'boolean', short: 'y' },
+                'skip-install': { type: 'boolean' },
+                help: { type: 'boolean', short: 'h' },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        process.stderr.write(`tracelane init: ${err instanceof Error ? err.message : String(err)}\n\n${INIT_HELP}`);
+        return 1;
+    }
+    if (parsed.values.help) {
+        process.stdout.write(INIT_HELP);
+        return 0;
+    }
+    const rawRunner = parsed.values.runner;
+    let runner;
+    if (rawRunner !== undefined) {
+        if (rawRunner !== 'wdio' && rawRunner !== 'playwright' && rawRunner !== 'cypress') {
+            process.stderr.write(`tracelane init: --runner must be one of wdio|playwright|cypress (got '${rawRunner}').\n`);
+            return 1;
+        }
+        runner = rawRunner;
+    }
+    return runInitProgrammatic({
+        cwd: process.cwd(),
+        runner,
+        dryRun: parsed.values['dry-run'] ?? false,
+        yes: parsed.values.yes ?? false,
+        skipInstall: parsed.values['skip-install'] ?? false,
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { INIT_HELP } from './commands/init.js';
+export declare function run(argv: readonly string[]): Promise<number>;
+/** Helper for tests that want the init help string. */
+export { INIT_HELP };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAYA,OAAO,EAAE,SAAS,EAAW,MAAM,oBAAoB,CAAC;AAexD,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlE;AAED,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,CAAC"}