@slowcook-ai/cli 0.25.0 → 0.28.0

package/dist/lib/browser/qa-replay.d.ts

@@ -0,0 +1,47 @@
+import type { BrowserDriver, DriverNeed } from "./driver.js";
+export interface QaStep {
+    action: "goto" | "click" | "fill" | "assert" | "screenshot" | "wait";
+    /** goto */ url?: string;
+    /** click/fill/assert */ selector?: string;
+    /** fill */ value?: string;
+    /** assert: a JS expression evaluated in the page; must be truthy (or === expect). */
+    expr?: string;
+    expect?: unknown;
+    /** screenshot */ path?: string;
+    /** wait */ ms?: number;
+}
+export interface QaPlan {
+    name: string;
+    /** prepended to a step's `url` when it's a path, not absolute. */
+    baseUrl?: string;
+    steps: QaStep[];
+}
+export interface StepResult {
+    i: number;
+    action: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface ReplayResult {
+    plan: string;
+    driver: string;
+    ok: boolean;
+    ms: number;
+    steps: StepResult[];
+    /** the step that failed, if any. */
+    failedAt?: number;
+}
+/** The capabilities a plan requires — only click+fill actions here, so "basic"
+ *  suffices (rustwright fits); screenshots/evaluate are in both engines. */
+export declare function planNeed(_plan: QaPlan): DriverNeed;
+/** Replay a plan on a driver. Stops at the first failed step (like a real test),
+ *  returns a per-step trace + total wall-time. */
+export declare function replayPlan(driver: BrowserDriver, plan: QaPlan): Promise<ReplayResult>;
+/** Replay a plan on the PROVEN-DEFAULT engine for QA replay: rustwright when it
+ *  fits + is installed (the ~65%-lighter footprint that matters for a fleet),
+ *  else Playwright (failover). Override with env SLOWCOOK_BROWSER. */
+export declare function replayPlanAuto(plan: QaPlan, env?: NodeJS.ProcessEnv): Promise<ReplayResult & {
+    engine: string;
+    failover: boolean;
+}>;
+//# sourceMappingURL=qa-replay.d.ts.map

package/dist/lib/browser/qa-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-replay.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/qa-replay.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;IACrE,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3C,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACvF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;4EAC4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAElD;AAKD;kDACkD;AAClD,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC3F;AAED;;sEAEsE;AACtE,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAIzI"}

package/dist/lib/browser/qa-replay.js

@@ -0,0 +1,69 @@
+import { selectDriver } from "./select.js";
+/** The capabilities a plan requires — only click+fill actions here, so "basic"
+ *  suffices (rustwright fits); screenshots/evaluate are in both engines. */
+export function planNeed(_plan) {
+    return { actions: "basic" };
+}
+const abs = (base, url) => /^[a-z]+:\/\//i.test(url) || url.startsWith("data:") ? url : `${(base ?? "").replace(/\/$/, "")}${url.startsWith("/") ? "" : "/"}${url}`;
+/** Replay a plan on a driver. Stops at the first failed step (like a real test),
+ *  returns a per-step trace + total wall-time. */
+export async function replayPlan(driver, plan) {
+    const t0 = Date.now();
+    const steps = [];
+    const session = await driver.launch();
+    const page = await session.newPage();
+    let ok = true;
+    let failedAt;
+    try {
+        for (let i = 0; i < plan.steps.length; i++) {
+            const s = plan.steps[i];
+            try {
+                switch (s.action) {
+                    case "goto":
+                        await page.goto(abs(plan.baseUrl, s.url ?? ""), { waitUntil: "load" });
+                        break;
+                    case "click":
+                        await page.click(s.selector ?? "");
+                        break;
+                    case "fill":
+                        await page.fill(s.selector ?? "", s.value ?? "");
+                        break;
+                    case "wait":
+                        await page.waitFor(s.ms ?? 100);
+                        break;
+                    case "screenshot":
+                        await page.screenshot({ path: s.path, fullPage: true });
+                        break;
+                    case "assert": {
+                        const got = await page.evaluate(s.expr ?? "false");
+                        const pass = "expect" in s ? JSON.stringify(got) === JSON.stringify(s.expect) : !!got;
+                        if (!pass)
+                            throw new Error(`assert failed: ${s.expr} → ${JSON.stringify(got)}${"expect" in s ? ` (expected ${JSON.stringify(s.expect)})` : ""}`);
+                        break;
+                    }
+                }
+                steps.push({ i, action: s.action, ok: true });
+            }
+            catch (e) {
+                ok = false;
+                failedAt = i;
+                steps.push({ i, action: s.action, ok: false, detail: e instanceof Error ? e.message : String(e) });
+                break; // stop at first failure
+            }
+        }
+    }
+    finally {
+        await page.close().catch(() => { });
+        await session.close().catch(() => { });
+    }
+    return { plan: plan.name, driver: driver.name, ok, ms: Date.now() - t0, steps, failedAt };
+}
+/** Replay a plan on the PROVEN-DEFAULT engine for QA replay: rustwright when it
+ *  fits + is installed (the ~65%-lighter footprint that matters for a fleet),
+ *  else Playwright (failover). Override with env SLOWCOOK_BROWSER. */
+export async function replayPlanAuto(plan, env) {
+    const sel = await selectDriver({ need: planNeed(plan), prefer: "rustwright", env });
+    const r = await replayPlan(sel.driver, plan);
+    return { ...r, engine: sel.driver.name, failover: !sel.usedPreferred };
+}
+//# sourceMappingURL=qa-replay.js.map

package/dist/lib/browser/qa-replay.js.map

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

package/dist/lib/browser/rustwright-driver.d.ts

@@ -0,0 +1,5 @@
+import type { BrowserDriver } from "./driver.js";
+/** true if the rustwright package is installed AND loads on this platform. */
+export declare function rustwrightAvailable(): Promise<boolean>;
+export declare function rustwrightDriver(): BrowserDriver;
+//# sourceMappingURL=rustwright-driver.d.ts.map

package/dist/lib/browser/rustwright-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rustwright-driver.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/rustwright-driver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAqD,MAAM,aAAa,CAAC;AAoBpG,8EAA8E;AAC9E,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE5D;AAoBD,wBAAgB,gBAAgB,IAAI,aAAa,CAmBhD"}

package/dist/lib/browser/rustwright-driver.js

@@ -0,0 +1,50 @@
+// rustwright can't emulate (newPage takes no options) and has no contexts; its
+// action surface is click + fill only.
+const CAPS = { emulation: false, contexts: false, actions: "basic" };
+/** true if the rustwright package is installed AND loads on this platform. */
+export async function rustwrightAvailable() {
+    try {
+        await import("rustwright");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function wrapPage(page, onClose) {
+    return {
+        goto: async (url, opts) => { await page.goto(url, { waitUntil: opts?.waitUntil ?? "load" }); },
+        evaluate: (expr) => page.evaluate(expr),
+        screenshot: (opts) => page.screenshot({ path: opts.path, fullPage: opts.fullPage ?? false }),
+        click: (sel) => page.click(sel),
+        fill: (sel, v) => page.fill(sel, v),
+        textContent: (sel) => page.textContent(sel),
+        title: () => page.title(),
+        // rustwright has no waitForTimeout — a plain sleep is equivalent for
+        // "let styles settle" waits.
+        waitFor: (ms) => sleep(ms),
+        close: onClose,
+    };
+}
+export function rustwrightDriver() {
+    return {
+        name: "rustwright",
+        caps: CAPS,
+        async launch() {
+            const rw = (await import("rustwright"));
+            const browser = await rw.chromium.launch();
+            return {
+                // no contexts: each page is a bare newPage on the shared browser. `emu`
+                // is IGNORED by design — the selector never routes an emulation-needing
+                // workload here, so this only runs for needs that don't require it.
+                async newPage(_emu) {
+                    const page = await browser.newPage();
+                    return wrapPage(page, async () => { });
+                },
+                close: () => browser.close(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=rustwright-driver.js.map

package/dist/lib/browser/rustwright-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rustwright-driver.js","sourceRoot":"","sources":["../../../src/lib/browser/rustwright-driver.ts"],"names":[],"mappings":"AAOA,+EAA+E;AAC/E,uCAAuC;AACvC,MAAM,IAAI,GAAe,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAgBjF,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,YAAsB,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACpF,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAE1E,SAAS,QAAQ,CAAC,IAAY,EAAE,OAA4B;IAC1D,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9F,QAAQ,EAAE,CAAI,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAe;QAChE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC5F,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACnC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;QAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE;QACzB,qEAAqE;QACrE,6BAA6B;QAC7B,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,EAAE,OAAO;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,IAAI;QACV,KAAK,CAAC,MAAM;YACV,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,YAAsB,CAAC,CAAwB,CAAC;YACzE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3C,OAAO;gBACL,wEAAwE;gBACxE,wEAAwE;gBACxE,oEAAoE;gBACpE,KAAK,CAAC,OAAO,CAAC,IAAiB;oBAC7B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrC,OAAO,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,GAAiD,CAAC,CAAC,CAAC;gBACvF,CAAC;gBACD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;aAC7B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/browser/select.d.ts

@@ -0,0 +1,21 @@
+import { type BrowserDriver, type DriverNeed } from "./driver.js";
+export interface SelectOptions {
+    /** what the workload requires; an engine is only picked if it satisfies all. */
+    need?: DriverNeed;
+    /** caller's preference; overridden by env SLOWCOOK_BROWSER. Default: playwright. */
+    prefer?: "playwright" | "rustwright";
+    /** override the env lookup (tests). */
+    env?: NodeJS.ProcessEnv;
+}
+export interface Selection {
+    driver: BrowserDriver;
+    /** true when the preferred engine was used; false when we failed over. */
+    usedPreferred: boolean;
+    /** human-readable why, for logs. */
+    reason: string;
+}
+/** Resolve which engine to use. env SLOWCOOK_BROWSER (playwright|rustwright) wins
+ *  over `prefer`; the result is Playwright unless rustwright is preferred, fits,
+ *  and is installed. NEVER throws for a missing rustwright — it fails over. */
+export declare function selectDriver(opts?: SelectOptions): Promise<Selection>;
+//# sourceMappingURL=select.d.ts.map

package/dist/lib/browser/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/select.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IACrC,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;+EAE+E;AAC/E,wBAAsB,YAAY,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqB/E"}

package/dist/lib/browser/select.js

@@ -0,0 +1,30 @@
+// Driver selection (2026-07-16) — Playwright is the default + failover; rustwright
+// is chosen only when explicitly preferred AND its capabilities fit the workload
+// AND it's installed. Anything else falls back to Playwright, with a reason.
+import { playwrightDriver } from "./playwright-driver.js";
+import { rustwrightDriver, rustwrightAvailable } from "./rustwright-driver.js";
+import { satisfies } from "./driver.js";
+/** Resolve which engine to use. env SLOWCOOK_BROWSER (playwright|rustwright) wins
+ *  over `prefer`; the result is Playwright unless rustwright is preferred, fits,
+ *  and is installed. NEVER throws for a missing rustwright — it fails over. */
+export async function selectDriver(opts = {}) {
+    const env = opts.env ?? process.env;
+    const envChoice = env["SLOWCOOK_BROWSER"]?.trim().toLowerCase();
+    const requested = envChoice === "rustwright" || envChoice === "playwright"
+        ? envChoice
+        : (opts.prefer ?? "playwright");
+    const need = opts.need ?? {};
+    if (requested !== "rustwright") {
+        return { driver: playwrightDriver(), usedPreferred: true, reason: "playwright (default)" };
+    }
+    // rustwright requested — only if it fits the need AND is installed.
+    const rw = rustwrightDriver();
+    if (!satisfies(rw.caps, need)) {
+        return { driver: playwrightDriver(), usedPreferred: false, reason: `rustwright can't satisfy ${JSON.stringify(need)} — using playwright` };
+    }
+    if (!(await rustwrightAvailable())) {
+        return { driver: playwrightDriver(), usedPreferred: false, reason: "rustwright not installed — using playwright" };
+    }
+    return { driver: rw, usedPreferred: true, reason: "rustwright (preferred, fits)" };
+}
+//# sourceMappingURL=select.js.map

package/dist/lib/browser/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/lib/browser/select.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,iFAAiF;AACjF,6EAA6E;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAuC,MAAM,aAAa,CAAC;AAmB7E;;+EAE+E;AAC/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,SAAS,GAAG,GAAG,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,SAAS,KAAK,YAAY,IAAI,SAAS,KAAK,YAAY;QACxE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7B,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC7F,CAAC;IAED,oEAAoE;IACpE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC7I,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,mBAAmB,EAAE,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC;IACrH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;AACrF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slowcook-ai/cli",
-  "version": "0.25.0",
+  "version": "0.28.0",
   "description": "CLI for the slowcook brewing harness",
   "license": "MIT",
   "author": "aminazar",
@@ -41,13 +41,13 @@
     "ts-morph": "^28.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@slowcook-ai/core": "^0.17.0",
-    "@slowcook-ai/stack-ts": "^0.9.9",
     "@slowcook-ai/forge-github": "^0.14.0",
+    "@slowcook-ai/stack-ts": "^0.9.9",
+    "@slowcook-ai/core": "^0.17.0",
     "@slowcook-ai/llm-anthropic": "^0.21.0",
-    "@slowcook-ai/gates": "^0.11.0",
-    "@slowcook-ai/review-overlay": "^0.11.0",
-    "@slowcook-ai/recorder": "^0.9.1"
+    "@slowcook-ai/recorder": "^0.9.1",
+    "@slowcook-ai/review-overlay": "^0.14.0",
+    "@slowcook-ai/gates": "^0.11.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.1"
@@ -58,6 +58,9 @@
   "engines": {
     "node": ">=20"
   },
+  "optionalDependencies": {
+    "rustwright": "^0.1.1"
+  },
   "scripts": {
     "build": "tsc -b",
     "test": "vitest run --passWithNoTests",