@tracelane/cli 0.1.0-alpha.1

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// `tracelane` CLI entry. v0.1 ships with a single `init` subcommand that
+// detects the user's test runner + package manager and wires @tracelane/wdio
+// into their wdio.conf.* in one shot. No-op coming-soon paths for Playwright
+// and Cypress.
+//
+// Arg parsing uses the built-in node:util.parseArgs at each command boundary
+// (no CLI framework dependency) — this top-level dispatcher just routes on
+// the first positional so the subcommand owns its own option schema, matching
+// the peek-cli pattern.
+import { realpathSync } from 'node:fs';
+import { INIT_HELP, runInit } from './commands/init.js';
+import { CLI_VERSION } from './version.js';
+const HELP = `tracelane ${CLI_VERSION} - drop-in test-failure replay reporter scaffolding
+
+Usage: npx tracelane <command> [options]
+
+Commands:
+  init                        Detect runner + wire @tracelane/wdio into the project
+
+Run \`npx tracelane <command> --help\` for command-specific options.
+
+Docs: https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-wdio
+`;
+export async function run(argv) {
+    const [command, ...rest] = argv;
+    switch (command) {
+        case 'init':
+            return runInit(rest);
+        case 'version':
+        case '--version':
+        case '-v':
+            process.stdout.write(`${CLI_VERSION}\n`);
+            return 0;
+        case 'help':
+        case '--help':
+        case '-h':
+            process.stdout.write(HELP);
+            return 0;
+        case undefined:
+            // Bare `npx tracelane` with no subcommand: print usage + exit 0 (per
+            // the v0.1 spec — friendlier than the peek-cli convention of exit 1
+            // for missing command, because tracelane has a single subcommand and
+            // most users discovering the package via `npx tracelane` haven't
+            // typed `init` yet).
+            process.stdout.write(HELP);
+            return 0;
+        default:
+            process.stderr.write(`tracelane: unknown command '${command}'\n\n`);
+            process.stdout.write(HELP);
+            return 1;
+    }
+}
+/** Helper for tests that want the init help string. */
+export { INIT_HELP };
+async function main() {
+    const code = await run(process.argv.slice(2));
+    process.exitCode = code;
+}
+// Only run as a CLI when invoked directly as the `tracelane` bin. When this
+// module is imported (tests or another package consuming `run`) an ESM
+// `import` has no side effects. Mirror peek-cli's guard so symlink/realpath
+// resolution doesn't break npx invocations.
+const invokedDirectly = process.argv[1] !== undefined &&
+    (import.meta.url === `file://${process.argv[1]}` ||
+        (() => {
+            try {
+                return import.meta.url === `file://${realpathSync(process.argv[1])}`;
+            }
+            catch {
+                return false;
+            }
+        })());
+if (invokedDirectly) {
+    main().catch((err) => {
+        process.stderr.write(`tracelane: fatal - ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,eAAe;AACf,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,wBAAwB;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,IAAI,GAAG,aAAa,WAAW;;;;;;;;;;CAUpC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,qEAAqE;YACrE,oEAAoE;YACpE,qEAAqE;YACrE,iEAAiE;YACjE,qBAAqB;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,OAAO,CAAC,CAAC;YACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,uEAAuE;AACvE,4EAA4E;AAC5E,4CAA4C;AAC5C,MAAM,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC9C,CAAC,GAAG,EAAE;YACJ,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,CAAC;AACV,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC1F,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/detect.d.ts

@@ -0,0 +1,59 @@
+/** The test runners tracelane recognises. Only WDIO is fully wired in v0.1. */
+export type Runner = 'wdio' | 'playwright' | 'cypress';
+/** The package managers tracelane recognises (lockfile-driven detection). */
+export type PackageManager = 'pnpm' | 'yarn' | 'npm' | 'bun';
+/** One detected runner + the config file that triggered the detection. */
+export interface DetectedRunner {
+    readonly runner: Runner;
+    /** Absolute path to the config file we matched on. */
+    readonly configPath: string;
+}
+/**
+ * Detect the test runner in `cwd`. Scans only the project root (not
+ * recursive) and returns the highest-priority match per RUNNER_SPECS. Returns
+ * `undefined` if nothing matched — the caller prints the "no runner detected"
+ * message and exits 1.
+ *
+ * `fileExists` is injected so unit tests can stub it; production callers pass
+ * the real `existsSync`.
+ */
+export declare function detectRunner(cwd: string, fileExists?: (path: string) => boolean): DetectedRunner | undefined;
+/**
+ * Detect runner where the user passed `--runner` explicitly. We still try to
+ * find a matching config file (so the caller can edit it later) — if none of
+ * the runner's known config-file shapes exists, we return the runner with a
+ * `configPath` of undefined and let the caller decide whether that's fatal.
+ *
+ * For the wdio happy path the editor requires `configPath`, so the caller
+ * should print a helpful "no wdio.conf.* found in {cwd}" message and exit 1.
+ */
+export declare function findRunnerConfig(cwd: string, runner: Runner, fileExists?: (path: string) => boolean): string | undefined;
+/** Result of package-manager detection. */
+export interface DetectedPackageManager {
+    readonly manager: PackageManager;
+    /** All lockfiles that were present (for the multiple-lockfiles warning). */
+    readonly lockfilesFound: readonly string[];
+    /** True if multiple lockfiles were present — caller should warn. */
+    readonly multipleLockfiles: boolean;
+    /** True if we fell back to `npm` because no lockfile was present. */
+    readonly fallback: boolean;
+}
+/**
+ * Detect the package manager in `cwd` from lockfile presence. If multiple
+ * lockfiles are present, prefers pnpm > yarn > npm > bun and flags it on the
+ * result. If none are present, defaults to `npm` with `fallback: true`.
+ */
+export declare function detectPackageManager(cwd: string, fileExists?: (path: string) => boolean): DetectedPackageManager;
+/**
+ * Build the package-manager install command for adding `@tracelane/wdio` as
+ * a devDependency. Returned as `[program, ...args]` for `spawnSync`, NOT a
+ * single shell string — `sh -c` is avoided to dodge injection on Windows and
+ * paths-with-spaces. Each manager has its own dev-flag spelling:
+ *
+ *   pnpm add -D @tracelane/wdio
+ *   yarn add -D @tracelane/wdio
+ *   npm install --save-dev @tracelane/wdio
+ *   bun add -d @tracelane/wdio
+ */
+export declare function installCommand(manager: PackageManager, pkg?: string): readonly string[];
+//# sourceMappingURL=detect.d.ts.map

package/dist/lib/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/lib/detect.ts"],"names":[],"mappings":"AAcA,+EAA+E;AAC/E,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAoC7D,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GACjD,cAAc,GAAG,SAAS,CAQ5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GACjD,MAAM,GAAG,SAAS,CAQpB;AAiBD,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GACjD,sBAAsB,CAsBxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,GAAG,SAAoB,GACtB,SAAS,MAAM,EAAE,CAWnB"}

package/dist/lib/detect.js

@@ -0,0 +1,140 @@
+// Pure detection helpers for `tracelane init`. Given a project root, figure
+// out (a) which test runner this is and (b) which package manager to use to
+// add the tracelane dependency. Everything in this file is a pure function of
+// (cwd, injected fileExists probe) → result, so it tests cheaply against
+// fixture trees and tempdirs.
+//
+// Runner detection looks ONLY at the project root, not recursively — a
+// wdio.conf inside node_modules is not the user's project. Priority order
+// when multiple match is WDIO > Playwright > Cypress (WDIO is the only path
+// the v0.1 CLI fully wires).
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+// Priority order: WDIO first because it's the only runner the CLI can wire
+// end-to-end today. Playwright + Cypress detection drives a no-op "support
+// coming Q3/Q4 2026" branch — they're listed so a user with both a Playwright
+// and a Cypress config still gets routed to the more-mature path.
+const RUNNER_SPECS = [
+    {
+        runner: 'wdio',
+        configFiles: ['wdio.conf.ts', 'wdio.conf.js', 'wdio.conf.mjs', 'wdio.conf.cjs'],
+    },
+    {
+        runner: 'playwright',
+        configFiles: [
+            'playwright.config.ts',
+            'playwright.config.js',
+            'playwright.config.mjs',
+            'playwright.config.cjs',
+        ],
+    },
+    {
+        runner: 'cypress',
+        configFiles: [
+            'cypress.config.ts',
+            'cypress.config.js',
+            'cypress.config.mjs',
+            'cypress.config.cjs',
+        ],
+    },
+];
+/**
+ * Detect the test runner in `cwd`. Scans only the project root (not
+ * recursive) and returns the highest-priority match per RUNNER_SPECS. Returns
+ * `undefined` if nothing matched — the caller prints the "no runner detected"
+ * message and exits 1.
+ *
+ * `fileExists` is injected so unit tests can stub it; production callers pass
+ * the real `existsSync`.
+ */
+export function detectRunner(cwd, fileExists = existsSync) {
+    for (const spec of RUNNER_SPECS) {
+        for (const f of spec.configFiles) {
+            const p = join(cwd, f);
+            if (fileExists(p))
+                return { runner: spec.runner, configPath: p };
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect runner where the user passed `--runner` explicitly. We still try to
+ * find a matching config file (so the caller can edit it later) — if none of
+ * the runner's known config-file shapes exists, we return the runner with a
+ * `configPath` of undefined and let the caller decide whether that's fatal.
+ *
+ * For the wdio happy path the editor requires `configPath`, so the caller
+ * should print a helpful "no wdio.conf.* found in {cwd}" message and exit 1.
+ */
+export function findRunnerConfig(cwd, runner, fileExists = existsSync) {
+    const spec = RUNNER_SPECS.find((s) => s.runner === runner);
+    if (!spec)
+        return undefined;
+    for (const f of spec.configFiles) {
+        const p = join(cwd, f);
+        if (fileExists(p))
+            return p;
+    }
+    return undefined;
+}
+// Priority order: pnpm > yarn > npm > bun, matching most monorepos' actual
+// preference. This is only consulted when MULTIPLE lockfiles exist — a
+// pathological repo state we warn about but don't refuse.
+const PM_SPECS = [
+    { manager: 'pnpm', lockfile: 'pnpm-lock.yaml' },
+    { manager: 'yarn', lockfile: 'yarn.lock' },
+    { manager: 'npm', lockfile: 'package-lock.json' },
+    { manager: 'bun', lockfile: 'bun.lockb' },
+];
+/**
+ * Detect the package manager in `cwd` from lockfile presence. If multiple
+ * lockfiles are present, prefers pnpm > yarn > npm > bun and flags it on the
+ * result. If none are present, defaults to `npm` with `fallback: true`.
+ */
+export function detectPackageManager(cwd, fileExists = existsSync) {
+    const present = PM_SPECS.filter((s) => fileExists(join(cwd, s.lockfile)));
+    if (present.length === 0) {
+        return {
+            manager: 'npm',
+            lockfilesFound: [],
+            multipleLockfiles: false,
+            fallback: true,
+        };
+    }
+    const top = present[0];
+    if (!top) {
+        // Unreachable — `present.length === 0` is handled above — but the
+        // noUncheckedIndexedAccess rule wants the explicit guard.
+        return { manager: 'npm', lockfilesFound: [], multipleLockfiles: false, fallback: true };
+    }
+    return {
+        manager: top.manager,
+        lockfilesFound: present.map((p) => p.lockfile),
+        multipleLockfiles: present.length > 1,
+        fallback: false,
+    };
+}
+/**
+ * Build the package-manager install command for adding `@tracelane/wdio` as
+ * a devDependency. Returned as `[program, ...args]` for `spawnSync`, NOT a
+ * single shell string — `sh -c` is avoided to dodge injection on Windows and
+ * paths-with-spaces. Each manager has its own dev-flag spelling:
+ *
+ *   pnpm add -D @tracelane/wdio
+ *   yarn add -D @tracelane/wdio
+ *   npm install --save-dev @tracelane/wdio
+ *   bun add -d @tracelane/wdio
+ */
+export function installCommand(manager, pkg = '@tracelane/wdio') {
+    switch (manager) {
+        case 'pnpm':
+            return ['pnpm', 'add', '-D', pkg];
+        case 'yarn':
+            return ['yarn', 'add', '-D', pkg];
+        case 'npm':
+            return ['npm', 'install', '--save-dev', pkg];
+        case 'bun':
+            return ['bun', 'add', '-d', pkg];
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/lib/detect.js.map

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

package/dist/lib/gitignore.d.ts

@@ -0,0 +1,17 @@
+/** The .gitignore entry we add (with a leading explanation comment). */
+export declare const TRACELANE_GITIGNORE_BLOCK = "\n# tracelane test-failure replay reports\ntracelane-reports/\n";
+/**
+ * True if the existing .gitignore content already covers `tracelane-reports/`.
+ * Matches the exact line OR an unanchored variant (`tracelane-reports`
+ * without the trailing slash) since git treats both the same way for an
+ * untracked directory.
+ */
+export declare function hasTracelaneEntry(existing: string): boolean;
+/**
+ * Produce the new .gitignore content after adding the tracelane entry. If the
+ * entry is already present (per `hasTracelaneEntry`), return the input
+ * unchanged. Inserts a leading newline if the file is non-empty and doesn't
+ * already end with one, so the comment doesn't glue onto a previous entry.
+ */
+export declare function mergeGitignore(existing: string): string;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/lib/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,oEAC6B,CAAC;AAKpE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQvD"}

package/dist/lib/gitignore.js

@@ -0,0 +1,40 @@
+// Pure helpers for adding `tracelane-reports/` to a project's .gitignore.
+// All file I/O lives in the command shell (init.ts) so we can test the merge
+// logic against in-memory strings.
+/** The .gitignore entry we add (with a leading explanation comment). */
+export const TRACELANE_GITIGNORE_BLOCK = '\n# tracelane test-failure replay reports\ntracelane-reports/\n';
+/** The bare entry line we look for when deciding "is this already covered?" */
+const TRACELANE_GITIGNORE_LINE = 'tracelane-reports/';
+/**
+ * True if the existing .gitignore content already covers `tracelane-reports/`.
+ * Matches the exact line OR an unanchored variant (`tracelane-reports`
+ * without the trailing slash) since git treats both the same way for an
+ * untracked directory.
+ */
+export function hasTracelaneEntry(existing) {
+    for (const raw of existing.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (line === TRACELANE_GITIGNORE_LINE)
+            return true;
+        if (line === 'tracelane-reports')
+            return true;
+    }
+    return false;
+}
+/**
+ * Produce the new .gitignore content after adding the tracelane entry. If the
+ * entry is already present (per `hasTracelaneEntry`), return the input
+ * unchanged. Inserts a leading newline if the file is non-empty and doesn't
+ * already end with one, so the comment doesn't glue onto a previous entry.
+ */
+export function mergeGitignore(existing) {
+    if (hasTracelaneEntry(existing))
+        return existing;
+    if (existing.length === 0) {
+        // Brand-new .gitignore: drop the leading newline.
+        return TRACELANE_GITIGNORE_BLOCK.replace(/^\n/, '');
+    }
+    const sep = existing.endsWith('\n') ? '' : '\n';
+    return `${existing}${sep}${TRACELANE_GITIGNORE_BLOCK.replace(/^\n/, '')}`;
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/lib/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAC7E,mCAAmC;AAEnC,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GACpC,iEAAiE,CAAC;AAEpE,+EAA+E;AAC/E,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,wBAAwB;YAAE,OAAO,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,mBAAmB;YAAE,OAAO,IAAI,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,kDAAkD;QAClD,OAAO,yBAAyB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,OAAO,GAAG,QAAQ,GAAG,GAAG,GAAG,yBAAyB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/lib/prompt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Yes/no confirm. `defaultYes` controls the [Y/n] vs [y/N] hint and the
+ * answer when the user just hits Enter on an empty line. Closes the readline
+ * interface in a `finally` so a Ctrl-C during the prompt doesn't leave stdin
+ * raw.
+ */
+export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/lib/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlF"}

package/dist/lib/prompt.js

@@ -0,0 +1,28 @@
+// Tiny zero-dependency `confirm` prompt over node:readline. Mirrors the
+// pattern used by peek-cli/src/lib/prompt.ts but pared down to the one form
+// `tracelane init` needs (yes/no with a default). No multi-select or
+// free-text prompts in v0.1.
+import { createInterface } from 'node:readline';
+function ask(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+/**
+ * Yes/no confirm. `defaultYes` controls the [Y/n] vs [y/N] hint and the
+ * answer when the user just hits Enter on an empty line. Closes the readline
+ * interface in a `finally` so a Ctrl-C during the prompt doesn't leave stdin
+ * raw.
+ */
+export async function confirm(message, defaultYes = true) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const suffix = defaultYes ? '[Y/n]' : '[y/N]';
+        const answer = (await ask(rl, `${message} ${suffix} `)).trim().toLowerCase();
+        if (answer.length === 0)
+            return defaultYes;
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/lib/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,qEAAqE;AACrE,6BAA6B;AAE7B,OAAO,EAAkB,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,SAAS,GAAG,CAAC,EAAa,EAAE,QAAgB;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,UAAU,GAAG,IAAI;IAC9D,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QAC3C,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/lib/wdio-editor.d.ts

@@ -0,0 +1,159 @@
+/** The import line we add at the top of the user's wdio.conf. */
+export declare const TRACELANE_IMPORT = "import TraceLaneService from '@tracelane/wdio';";
+/** The services-array entry we add. Tuple form: [Service, options]. */
+export declare const TRACELANE_SERVICE_TUPLE = "[TraceLaneService, { mode: 'failed' }]";
+/**
+ * Sanity bounds for the post-edit byte-count delta. The lower bound is
+ * different for the "added both import + entry" path vs the "entry only
+ * (idempotent import already present)" path — the import line alone is
+ * already ~50 bytes, so an entry-only edit can legitimately grow by less.
+ */
+export declare const EDIT_DELTA_MIN = 80;
+export declare const EDIT_DELTA_MIN_ENTRY_ONLY = 30;
+export declare const EDIT_DELTA_MAX = 400;
+/** A `services: [...]` literal block we found inside the source. */
+interface ServicesBlock {
+    /** Absolute character offset of the opening `[`. */
+    readonly openIndex: number;
+    /** Absolute character offset of the matching closing `]`. */
+    readonly closeIndex: number;
+    /** Substring between `[` and `]` (exclusive). */
+    readonly inner: string;
+}
+/**
+ * Produce a same-length copy of `src` where every string literal and every
+ * comment is replaced with a same-length space-padded run. Newlines inside
+ * line comments and block comments are preserved (so regex anchors like
+ * `^...$` with the `m` flag still see the same line structure).
+ *
+ * Inside template literals (backtick), `${...}` interpolation BODIES are
+ * treated as code — we re-enter normal mode for the interpolated expression
+ * so a `services:` mention there isn't shadowed. This is rare in practice
+ * (configs don't usually compute the services array via template literals)
+ * but it's cheap to do right.
+ */
+export declare function stripStringsAndComments(src: string): string;
+/**
+ * Locate the `services:` array literal in a wdio.conf source string. Returns
+ * the bracket indices + the substring inside.
+ *
+ * The match runs against `stripStringsAndComments(source)` so a `services:`
+ * inside a comment or a string can never be selected. Among the remaining
+ * candidates, we prefer the SHALLOWEST brace+bracket depth — this rejects
+ * `capabilities: [{ services: ['safari'] }]` (depth 3) in favour of the
+ * outer testrunner `services:` (depth 1). The depth-1 preference matches
+ * the WDIO config schema (services live directly on the config object).
+ *
+ * Returns `undefined` if no `services:` key with an array literal is present
+ * outside strings/comments.
+ */
+export declare function findServicesArray(source: string): ServicesBlock | undefined;
+/**
+ * Insert the tracelane import after the LAST `import ... from '...';` line in
+ * the source. If no imports exist (which should never happen for a real WDIO
+ * conf) we insert at the top.
+ *
+ * We don't attempt to deduplicate or sort — the user's editor + Biome will
+ * fold our line in on the next save. Idempotency is enforced by the caller
+ * (it checks `hasTracelaneImport(source)` before invoking this).
+ *
+ * Match runs against the stripped buffer so a top-of-file block comment
+ * mentioning `import` cannot shadow the real import section.
+ */
+export declare function insertTracelaneImport(source: string): string;
+/**
+ * True if the source already has an `@tracelane/wdio` import. Matches both
+ * default and named import forms (`import TraceLaneService from ...` /
+ * `import { TraceLaneService } from ...`) and either quote style. Runs
+ * against the stripped buffer so a commented-out example
+ *   // import TraceLaneService from '@tracelane/wdio';
+ * doesn't false-positive — but the stripped buffer preserves the import
+ * keyword itself, so a real import is still detected.
+ *
+ * Wait — we DO want to match the literal '@tracelane/wdio' inside the
+ * `from '...'` clause. The strip replaces string CONTENT with spaces, so
+ * `from '@tracelane/wdio'` becomes `from '              '` in the stripped
+ * buffer. We need to recognise the real import by structure: the keyword
+ * `import`, the binding, `from`, a string literal of any contents. We test
+ * the structural shape on the stripped buffer, then verify the string
+ * literal's contents against the RAW source at the matched offsets.
+ */
+export declare function hasTracelaneImport(source: string): boolean;
+/**
+ * True if the source already mentions the TraceLaneService in a services
+ * array entry — either bare (`TraceLaneService`) or tuple
+ * (`[TraceLaneService, ...]`). Runs against the stripped buffer to ignore
+ * comment + string mentions.
+ */
+export declare function hasTracelaneServiceEntry(source: string): boolean;
+/**
+ * Insert `[TraceLaneService, { mode: 'failed' }]` as the LAST element of an
+ * existing services array. Three input shapes covered:
+ *
+ *   services: []                  → services: [[Service, opts]]
+ *   services: ['devtools']        → services: ['devtools', [Service, opts]]
+ *   services: [['devtools', {}]]  → services: [['devtools', {}], [Service, opts]]
+ *
+ * Returns the new full source. Caller has already located `block` via
+ * `findServicesArray`.
+ */
+export declare function appendToServicesArray(source: string, block: ServicesBlock): string;
+/**
+ * Insert a `services: [[TraceLaneService, ...]]` line into a config object
+ * that has no `services:` key at all.
+ *
+ * Strategy: find the FIRST top-level `export const config` / `export default`
+ * config object literal, locate its outermost `{`/`}`, and insert
+ *   services: [[TraceLaneService, { mode: 'failed' }]],
+ * just before the closing `}`. If we can't find the object literal, return
+ * undefined and let the caller back out to the manual-snippet path.
+ *
+ * Runs against the stripped buffer so an `export default { ... }` string in
+ * a doc-comment header can't be matched.
+ */
+export declare function insertServicesKey(source: string): string | undefined;
+/** Result shape for `applyWdioEdit`. */
+export type WdioEditResult = {
+    readonly ok: true;
+    /** The new source content to write back. */
+    readonly source: string;
+    /** True if the source already had the import + service entry — no-op. */
+    readonly alreadyConfigured: boolean;
+    /** True if we ADDED the import (false on idempotent re-run). */
+    readonly addedImport: boolean;
+    /** True if we ADDED the service-array entry. */
+    readonly addedServiceEntry: boolean;
+} | {
+    readonly ok: false;
+    /** The reason the editor backed out. Surfaced verbatim to the user. */
+    readonly reason: string;
+    /** The snippet the user should paste manually (always populated). */
+    readonly manualSnippet: string;
+};
+/**
+ * Manual-paste snippet shown when the editor backs out. The user pastes this
+ * at the top of their conf and adds the tuple to `services:` themselves.
+ *
+ * This is the single source of truth — `init.ts`'s "restored from backup"
+ * path also references this constant so the snippet copy doesn't drift.
+ */
+export declare const MANUAL_SNIPPET = "import TraceLaneService from '@tracelane/wdio';\n\n// Inside your config object's `services` array:\n//   services: [[TraceLaneService, { mode: 'failed' }]],\n";
+/**
+ * The single high-level entrypoint. Given the current source of a
+ * wdio.conf.*, produce the new source (with the import + service tuple
+ * added) — or fail cleanly with a manual snippet for the user to paste.
+ *
+ * Steps:
+ *   1. If both the import + the service entry are already present, no-op.
+ *   2. Add the import if it's missing.
+ *   3. Append to the existing `services: [...]` array, OR insert a new
+ *      `services:` key if none exists.
+ *   4. Sanity-check the byte-count delta + presence of the marker strings.
+ *
+ * The sanity check at the END is the safety net: if our regex went off the
+ * rails (e.g. landed on an unusual shape) the delta is wildly wrong and we
+ * back out instead of writing a corrupt file.
+ */
+export declare function applyWdioEdit(originalSource: string): WdioEditResult;
+export {};
+//# sourceMappingURL=wdio-editor.d.ts.map

package/dist/lib/wdio-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wdio-editor.d.ts","sourceRoot":"","sources":["../../src/lib/wdio-editor.ts"],"names":[],"mappings":"AAuCA,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,oDAAoD,CAAC;AAElF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,2CAA2C,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,oEAAoE;AACpE,UAAU,aAAa;IACrB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqG3D;AAwED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CA6B3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgB5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgB1D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAoBlF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUpE;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,oKAI1B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,CA6EpE"}