@jevitate/cli 0.1.0 → 0.2.0

package/dist/explore-author.js

@@ -0,0 +1,86 @@
+import { PlaywrightBrowserPort } from "@jevitate/playwright";
+import { sessionLaunchOptions } from "./browser-run-options.js";
+import { CastActor, BrowseTheWeb } from "@jevitate/screenplay";
+import { authorJourney, assertAuthorizedExploreTarget, } from "@jevitate/explore";
+import { FsJourneyStore } from "@jevitate/journey";
+/**
+ * The programmatic surface behind `jevitate explore author-journey` — drives
+ * the goal-based exploration mission and feeds its take(s) through RxD's
+ * diff/postdoc pipeline (`@jevitate/explore`'s `authorJourney`) to author a
+ * parameterized, replayable, UNPROMOTED Journey, then persists it under the
+ * journeys store. Additive: the record-by-demonstration authoring path is
+ * untouched.
+ *
+ * The authorized-target guard runs FIRST (fail-closed), before any browser is
+ * opened. The authoring step is injectable (`authorImpl`) so it is unit-testable
+ * without a browser.
+ */
+export async function runAuthorJourney(opts) {
+    // Guardrail #1 — authorize BEFORE opening a browser. Throws on refusal.
+    const origin = assertAuthorizedExploreTarget(opts.url, opts.allowlist);
+    const impl = opts.authorImpl ?? authorViaBrowser;
+    const result = await impl({
+        url: opts.url,
+        origin,
+        goal: opts.goal,
+        successAssertion: opts.successAssertion,
+        allowlist: opts.allowlist,
+        judge: opts.judge,
+        gen: opts.gen,
+        bounds: opts.bounds,
+        takes: opts.takes ?? 1,
+        journeyId: opts.journeyId,
+        journeyName: opts.journeyName,
+        browserPortFactory: opts.browserPortFactory,
+        browser: opts.browser,
+        ...(opts.storageState !== undefined ? { storageState: opts.storageState } : {}),
+        ...(opts.safety === undefined ? {} : { safety: opts.safety }),
+    });
+    if (result.outcome === "authored") {
+        // #170: a Journey authored behind a login (--storage-state) declares it, so a run without a
+        // storage state fails fast as a configuration error instead of a gating step-1 assertion.
+        const journey = opts.storageState !== undefined && result.journey.metadata.requiresAuth !== true
+            ? { ...result.journey, metadata: { ...result.journey.metadata, requiresAuth: true } }
+            : result.journey;
+        await new FsJourneyStore(opts.journeysDir).put(journey);
+        return journey === result.journey ? result : { ...result, journey };
+    }
+    return result;
+}
+/** Default authoring step: opens a real browser, builds an actor, authors. */
+async function authorViaBrowser(args) {
+    if (!args.judge || !args.gen) {
+        throw new Error("runAuthorJourney: judge and gen gateways are required to drive the authoring mission");
+    }
+    const judge = args.judge;
+    const gen = args.gen;
+    const portFactory = args.browserPortFactory ?? (() => new PlaywrightBrowserPort());
+    const port = portFactory();
+    const session = await port.open({
+        ...sessionLaunchOptions(args.browser),
+        allowedOrigins: [...args.allowlist],
+        baseUrl: args.origin,
+        ...(args.storageState !== undefined ? { storageState: args.storageState } : {}),
+    });
+    try {
+        const actor = CastActor.named("author").whoCan(new BrowseTheWeb(session, [...args.allowlist]));
+        return await authorJourney({
+            goal: args.goal,
+            successAssertion: args.successAssertion,
+            allowlist: args.allowlist,
+            startUrl: args.url,
+            bounds: args.bounds,
+            actor,
+            judgment: judge,
+            generation: gen,
+            takes: args.takes,
+            journeyId: args.journeyId,
+            journeyName: args.journeyName,
+            ...(args.safety === undefined ? {} : { safety: args.safety }),
+        });
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=explore-author.js.map

package/dist/explore-author.js.map

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

package/dist/explore-cli.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+/**
+ * Registers `jevitate explore` (every strategy: goal, coverage, exploratory, adversarial, usability, feature, multi-run).
+ * `buildProgram` builds a fresh program for each run of a multi-run (#141/#143).
+ */
+export declare function registerExploreCommands(program: Command, deps: CliDeps, buildProgram: (deps: CliDeps) => Command): void;