@cat-factory/contracts 0.75.0 → 0.77.0

package/dist/frontend.d.ts

@@ -0,0 +1,145 @@
+import * as v from 'valibot';
+/**
+ * Default WireMock `--root-dir` in the FE repo when a `frontend` frame declares no
+ * {@link frontendConfigSchema.mockMappingsPath}. The single source of truth shared by the
+ * frontend-aware mocker prompt (`@cat-factory/agents`) and the harness `frontend` infra spec —
+ * WireMock reads stubs from `<dir>/mappings/*.json` + `<dir>/__files/` under it. (The harness
+ * package keeps its own literal copy because bumping it is an image-tag change; keep the two in
+ * lock-step.)
+ */
+export declare const DEFAULT_FRONTEND_MOCK_MAPPINGS_PATH = "mocks/";
+/** The package manager the frontend build uses. Defaults to `pnpm`. */
+export declare const frontendPackageManagerSchema: v.PicklistSchema<["pnpm", "npm", "yarn"], undefined>;
+export type FrontendPackageManager = v.InferOutput<typeof frontendPackageManagerSchema>;
+/**
+ * How the built app is served in the UI-test container:
+ *   - `static`  — serve the built `outputDir` with a static file server (default).
+ *   - `command` — run a package.json script (`serveScript`, e.g. `preview`).
+ */
+export declare const frontendServeModeSchema: v.PicklistSchema<["static", "command"], undefined>;
+export type FrontendServeMode = v.InferOutput<typeof frontendServeModeSchema>;
+/**
+ * When the resolved backend URLs are injected into the frontend:
+ *   - `build`   — as build-time env vars (default; a `VITE_*`/`PUB_*` build).
+ *   - `runtime` — written into a `window.env` shim served alongside the app.
+ */
+export declare const frontendEnvInjectionSchema: v.PicklistSchema<["build", "runtime"], undefined>;
+export type FrontendEnvInjection = v.InferOutput<typeof frontendEnvInjectionSchema>;
+/**
+ * Where one of the frontend's backend env vars resolves at test/preview time:
+ *   - `service` — that service frame's live ephemeral-environment URL (the
+ *     "service under test"). `serviceBlockId` is the bound service frame's block id.
+ *   - `mock`    — WireMock on localhost (every upstream that is NOT the service
+ *     under test resolves here).
+ */
+export declare const frontendBackendSourceSchema: v.VariantSchema<"kind", [v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"service", undefined>;
+    readonly serviceBlockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>, v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"mock", undefined>;
+}, undefined>], undefined>;
+export type FrontendBackendSource = v.InferOutput<typeof frontendBackendSourceSchema>;
+/**
+ * One backend binding: the env var the frontend reads for an upstream URL, and
+ * where that URL comes from. This is BOTH the user-declared config (env-var name
+ * + which upstream) AND the board link (a `service` source draws a frontend→service
+ * edge). The "service under test" is the bound `service` source whose ephemeral env
+ * is live; every other binding resolves to WireMock.
+ */
+export declare const frontendBackendBindingSchema: v.ObjectSchema<{
+    /**
+     * The frontend's env var name for this upstream URL (e.g. `PUB_BACKEND_URL`). May be
+     * empty as a transient editing state (a freshly-added inspector row before the user
+     * types a name); the infra/job-body builder filters empty-envVar bindings out, so an
+     * empty one is inert rather than injected.
+     */
+    readonly envVar: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>;
+    readonly source: v.VariantSchema<"kind", [v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"service", undefined>;
+        readonly serviceBlockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"mock", undefined>;
+    }, undefined>], undefined>;
+}, undefined>;
+export type FrontendBackendBinding = v.InferOutput<typeof frontendBackendBindingSchema>;
+/**
+ * Which branch the frontend is built from for a UI test / preview:
+ *   - `'default'` — the frontend repo's default branch (the baseline).
+ *   - `{ fromTaskBlockId }` — the PR branch of a linked frontend task block, so a
+ *     UI test runs against that task's unmerged work.
+ * Absent ⇒ `'default'`.
+ */
+export declare const frontendBranchSchema: v.VariantSchema<"kind", [v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"default", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"task", undefined>;
+    readonly fromTaskBlockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>], undefined>;
+export type FrontendBranch = v.InferOutput<typeof frontendBranchSchema>;
+/**
+ * Service-level (frame-only, `type: 'frontend'`): how to build, serve, and mock
+ * this frontend for a self-contained UI test (and, on local/node, an optional
+ * browsable preview). Stored serialized on the block. All fields optional except
+ * {@link backendBindings}; the harness / job-body builder supplies the defaults
+ * (packageManager `pnpm`, buildScript `build`, outputDir `dist`, serveMode
+ * `static`, servePort 4173, envInjection `build`, mockMappingsPath `mocks/`).
+ */
+export declare const frontendConfigSchema: v.ObjectSchema<{
+    /** Package manager for install/build. Default `pnpm`. */
+    readonly packageManager: v.OptionalSchema<v.PicklistSchema<["pnpm", "npm", "yarn"], undefined>, undefined>;
+    /** Explicit install command, overriding the one derived from `packageManager`. */
+    readonly installCommand: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    /** package.json script name that produces the built app. Default `build`. */
+    readonly buildScript: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+    /** The build's output directory, served in `static` mode. Default `dist`. */
+    readonly outputDir: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    /** How the built app is served. Default `static`. */
+    readonly serveMode: v.OptionalSchema<v.PicklistSchema<["static", "command"], undefined>, undefined>;
+    /** package.json script to run when `serveMode: 'command'` (e.g. `preview`). */
+    readonly serveScript: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+    /**
+     * The port the served app listens on inside the container. Default 4173 (deliberately NOT
+     * 8080: the harness's own job HTTP server owns 8080 in the same container). Avoid 8080.
+     */
+    readonly servePort: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 65535, undefined>]>, undefined>;
+    /** Build-time env vars vs a runtime `window.env` shim. Default `build`. */
+    readonly envInjection: v.OptionalSchema<v.PicklistSchema<["build", "runtime"], undefined>, undefined>;
+    /** Which branch to build for a UI test / preview. Absent ⇒ the FE default branch. */
+    readonly branch: v.OptionalSchema<v.VariantSchema<"kind", [v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"default", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"task", undefined>;
+        readonly fromTaskBlockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    }, undefined>], undefined>, undefined>;
+    /**
+     * WireMock's `--root-dir` in the FE repo. Default `mocks/`. NOTE: WireMock loads stubs from a
+     * `mappings/` subdirectory (and response bodies from `__files/`) UNDER this dir — so with the
+     * default, put stub JSON in `mocks/mappings/`, not directly in `mocks/`. A dir with no
+     * `mappings/` inside starts an empty WireMock that 404s every mocked call.
+     */
+    readonly mockMappingsPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    /** Browsable preview (local/node only). Default false. */
+    readonly previewEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /**
+     * The frontend's backend upstreams: env-var name → where the URL resolves. Both
+     * the config and the board link. Required (may be empty for a frontend with no
+     * backend upstreams, but the field is always present).
+     */
+    readonly backendBindings: v.ArraySchema<v.ObjectSchema<{
+        /**
+         * The frontend's env var name for this upstream URL (e.g. `PUB_BACKEND_URL`). May be
+         * empty as a transient editing state (a freshly-added inspector row before the user
+         * types a name); the infra/job-body builder filters empty-envVar bindings out, so an
+         * empty one is inert rather than injected.
+         */
+        readonly envVar: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>;
+        readonly source: v.VariantSchema<"kind", [v.ObjectSchema<{
+            readonly kind: v.LiteralSchema<"service", undefined>;
+            readonly serviceBlockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        }, undefined>, v.ObjectSchema<{
+            readonly kind: v.LiteralSchema<"mock", undefined>;
+        }, undefined>], undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type FrontendConfig = v.InferOutput<typeof frontendConfigSchema>;
+//# sourceMappingURL=frontend.d.ts.map

package/dist/frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.d.ts","sourceRoot":"","sources":["../src/frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,WAAW,CAAA;AAE3D,uEAAuE;AACvE,eAAO,MAAM,4BAA4B,sDAAsC,CAAA;AAC/E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,oDAAoC,CAAA;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,mDAAmC,CAAA;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;0BAQtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;IACvC;;;;;OAKG;;;;;;;;aAGH,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;0BAM/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;IAC/B,yDAAyD;;IAEzD,kFAAkF;;IAElF,6EAA6E;;IAE7E,6EAA6E;;IAE7E,qDAAqD;;IAErD,+EAA+E;;IAE/E;;;OAGG;;IAEH,2EAA2E;;IAE3E,qFAAqF;;;;;;;IAErF;;;;;OAKG;;IAEH,0DAA0D;;IAE1D;;;;OAIG;;QAtEH;;;;;WAKG;;;;;;;;;aAmEH,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/frontend.js

@@ -0,0 +1,130 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Frontend board block config.
+//
+// A `frontend`-type frame carries a serialized `FrontendConfig` (stored on the
+// block, mirroring how `provisioning` is stored on a service frame). It declares
+// HOW to build and serve the app for a self-contained UI test — the package
+// manager, build script, serve mode, and the WireMock mappings dir — plus the
+// backend bindings that ARE both the config and the board link: each binding
+// names an env var and where it resolves (a bound service's ephemeral env URL, or
+// WireMock). Every field is optional except `backendBindings`; the harness /
+// job-body builder fills the defaults (pnpm, `build`, `dist`, static serve, …).
+// ---------------------------------------------------------------------------
+/**
+ * Default WireMock `--root-dir` in the FE repo when a `frontend` frame declares no
+ * {@link frontendConfigSchema.mockMappingsPath}. The single source of truth shared by the
+ * frontend-aware mocker prompt (`@cat-factory/agents`) and the harness `frontend` infra spec —
+ * WireMock reads stubs from `<dir>/mappings/*.json` + `<dir>/__files/` under it. (The harness
+ * package keeps its own literal copy because bumping it is an image-tag change; keep the two in
+ * lock-step.)
+ */
+export const DEFAULT_FRONTEND_MOCK_MAPPINGS_PATH = 'mocks/';
+/** The package manager the frontend build uses. Defaults to `pnpm`. */
+export const frontendPackageManagerSchema = v.picklist(['pnpm', 'npm', 'yarn']);
+/**
+ * How the built app is served in the UI-test container:
+ *   - `static`  — serve the built `outputDir` with a static file server (default).
+ *   - `command` — run a package.json script (`serveScript`, e.g. `preview`).
+ */
+export const frontendServeModeSchema = v.picklist(['static', 'command']);
+/**
+ * When the resolved backend URLs are injected into the frontend:
+ *   - `build`   — as build-time env vars (default; a `VITE_*`/`PUB_*` build).
+ *   - `runtime` — written into a `window.env` shim served alongside the app.
+ */
+export const frontendEnvInjectionSchema = v.picklist(['build', 'runtime']);
+/**
+ * Where one of the frontend's backend env vars resolves at test/preview time:
+ *   - `service` — that service frame's live ephemeral-environment URL (the
+ *     "service under test"). `serviceBlockId` is the bound service frame's block id.
+ *   - `mock`    — WireMock on localhost (every upstream that is NOT the service
+ *     under test resolves here).
+ */
+export const frontendBackendSourceSchema = v.variant('kind', [
+    v.object({
+        kind: v.literal('service'),
+        serviceBlockId: v.pipe(v.string(), v.minLength(1)),
+    }),
+    v.object({
+        kind: v.literal('mock'),
+    }),
+]);
+/**
+ * One backend binding: the env var the frontend reads for an upstream URL, and
+ * where that URL comes from. This is BOTH the user-declared config (env-var name
+ * + which upstream) AND the board link (a `service` source draws a frontend→service
+ * edge). The "service under test" is the bound `service` source whose ephemeral env
+ * is live; every other binding resolves to WireMock.
+ */
+export const frontendBackendBindingSchema = v.object({
+    /**
+     * The frontend's env var name for this upstream URL (e.g. `PUB_BACKEND_URL`). May be
+     * empty as a transient editing state (a freshly-added inspector row before the user
+     * types a name); the infra/job-body builder filters empty-envVar bindings out, so an
+     * empty one is inert rather than injected.
+     */
+    envVar: v.pipe(v.string(), v.trim(), v.maxLength(200)),
+    source: frontendBackendSourceSchema,
+});
+/**
+ * Which branch the frontend is built from for a UI test / preview:
+ *   - `'default'` — the frontend repo's default branch (the baseline).
+ *   - `{ fromTaskBlockId }` — the PR branch of a linked frontend task block, so a
+ *     UI test runs against that task's unmerged work.
+ * Absent ⇒ `'default'`.
+ */
+export const frontendBranchSchema = v.variant('kind', [
+    v.object({ kind: v.literal('default') }),
+    v.object({
+        kind: v.literal('task'),
+        fromTaskBlockId: v.pipe(v.string(), v.minLength(1)),
+    }),
+]);
+/**
+ * Service-level (frame-only, `type: 'frontend'`): how to build, serve, and mock
+ * this frontend for a self-contained UI test (and, on local/node, an optional
+ * browsable preview). Stored serialized on the block. All fields optional except
+ * {@link backendBindings}; the harness / job-body builder supplies the defaults
+ * (packageManager `pnpm`, buildScript `build`, outputDir `dist`, serveMode
+ * `static`, servePort 4173, envInjection `build`, mockMappingsPath `mocks/`).
+ */
+export const frontendConfigSchema = v.object({
+    /** Package manager for install/build. Default `pnpm`. */
+    packageManager: v.optional(frontendPackageManagerSchema),
+    /** Explicit install command, overriding the one derived from `packageManager`. */
+    installCommand: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(400))),
+    /** package.json script name that produces the built app. Default `build`. */
+    buildScript: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(200))),
+    /** The build's output directory, served in `static` mode. Default `dist`. */
+    outputDir: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(400))),
+    /** How the built app is served. Default `static`. */
+    serveMode: v.optional(frontendServeModeSchema),
+    /** package.json script to run when `serveMode: 'command'` (e.g. `preview`). */
+    serveScript: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(200))),
+    /**
+     * The port the served app listens on inside the container. Default 4173 (deliberately NOT
+     * 8080: the harness's own job HTTP server owns 8080 in the same container). Avoid 8080.
+     */
+    servePort: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(65535))),
+    /** Build-time env vars vs a runtime `window.env` shim. Default `build`. */
+    envInjection: v.optional(frontendEnvInjectionSchema),
+    /** Which branch to build for a UI test / preview. Absent ⇒ the FE default branch. */
+    branch: v.optional(frontendBranchSchema),
+    /**
+     * WireMock's `--root-dir` in the FE repo. Default `mocks/`. NOTE: WireMock loads stubs from a
+     * `mappings/` subdirectory (and response bodies from `__files/`) UNDER this dir — so with the
+     * default, put stub JSON in `mocks/mappings/`, not directly in `mocks/`. A dir with no
+     * `mappings/` inside starts an empty WireMock that 404s every mocked call.
+     */
+    mockMappingsPath: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(400))),
+    /** Browsable preview (local/node only). Default false. */
+    previewEnabled: v.optional(v.boolean()),
+    /**
+     * The frontend's backend upstreams: env-var name → where the URL resolves. Both
+     * the config and the board link. Required (may be empty for a frontend with no
+     * backend upstreams, but the field is always present).
+     */
+    backendBindings: v.array(frontendBackendBindingSchema),
+});
+//# sourceMappingURL=frontend.js.map

package/dist/frontend.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './primitives.js';
 export * from './errors.js';
 export * from './entities.js';
+export * from './frontend.js';
+export * from './visual-pipeline.js';
 export * from './services.js';
 export * from './fragment-library.js';
 export * from './accounts.js';
@@ -16,6 +18,7 @@ export * from './environments.js';
 export * from './runners.js';
 export * from './bootstrap.js';
 export * from './env-config-repair.js';
+export * from './infra-setup.js';
 export * from './snapshot.js';
 export * from './board-scan.js';
 export * from './iteration-cap.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from './primitives.js';
 export * from './errors.js';
 export * from './entities.js';
+export * from './frontend.js';
+export * from './visual-pipeline.js';
 export * from './services.js';
 export * from './fragment-library.js';
 export * from './accounts.js';
@@ -16,6 +18,7 @@ export * from './environments.js';
 export * from './runners.js';
 export * from './bootstrap.js';
 export * from './env-config-repair.js';
+export * from './infra-setup.js';
 export * from './snapshot.js';
 export * from './board-scan.js';
 export * from './iteration-cap.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}

package/dist/infra-setup.d.ts

@@ -0,0 +1,40 @@
+import * as v from 'valibot';
+/**
+ * The configuration state of one infrastructure area for a workspace:
+ *  - `not_defined`    — the deployment can use it, but the operator hasn't set it up
+ *                       (the banner-worthy state).
+ *  - `configured`     — a connection / backend is defined.
+ *  - `not_applicable` — this runtime doesn't need it (the integration isn't wired),
+ *                       so there is nothing to nag about.
+ */
+export declare const infraSetupStatusSchema: v.PicklistSchema<["not_defined", "configured", "not_applicable"], undefined>;
+export type InfraSetupStatus = v.InferOutput<typeof infraSetupStatusSchema>;
+/** The per-area infrastructure-setup status projection carried on the snapshot. */
+export declare const infraSetupSchema: v.ObjectSchema<{
+    /** Ephemeral test environments (deployer / provisioning). Relevant on every runtime. */
+    readonly ephemeralEnvironments: v.PicklistSchema<["not_defined", "configured", "not_applicable"], undefined>;
+    /** The container agent executor (self-hosted runner pool). Relevant only on remote Node. */
+    readonly agentExecutor: v.PicklistSchema<["not_defined", "configured", "not_applicable"], undefined>;
+    /**
+     * Binary/object storage for UI screenshots + reference images. Every facade wires an
+     * artifact-store resolver, so this is `configured`/`not_defined` on every runtime — not just
+     * remote Node: a Cloudflare deployment WITHOUT an `ARTIFACT_BUCKET` binding (or any account
+     * that selected no backend) reads `not_defined` too.
+     */
+    readonly binaryStorage: v.PicklistSchema<["not_defined", "configured", "not_applicable"], undefined>;
+}, undefined>;
+export type InfraSetup = v.InferOutput<typeof infraSetupSchema>;
+/** The infrastructure areas the setup banner surfaces (leaf names mirror {@link infraSetupSchema}). */
+export declare const infraSetupAreaSchema: v.PicklistSchema<["ephemeralEnvironments", "agentExecutor", "binaryStorage"], undefined>;
+export type InfraSetupArea = v.InferOutput<typeof infraSetupAreaSchema>;
+/** Every infra-setup area, as a plain readonly tuple (the source of truth for iteration). */
+export declare const INFRA_SETUP_AREAS: ["ephemeralEnvironments", "agentExecutor", "binaryStorage"];
+/**
+ * The `localStorage` key under which the SPA's `InfraSetupBanner` persists its PERMANENT,
+ * per-user "don't notify me again" dismissals ({@link InfraSetupArea}[] keyed by user id).
+ * Lives in this dependency-free contracts package — rather than only inside the Vue component —
+ * so the SPA and the e2e suite (which seeds the same key to suppress the banner) share ONE
+ * source of truth and can't drift.
+ */
+export declare const INFRA_SETUP_DISMISSED_STORAGE_KEY = "cat-factory:infra-setup-dismissed";
+//# sourceMappingURL=infra-setup.d.ts.map

package/dist/infra-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-setup.d.ts","sourceRoot":"","sources":["../src/infra-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4B5B;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,8EAA8D,CAAA;AACjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,mFAAmF;AACnF,eAAO,MAAM,gBAAgB;IAC3B,wFAAwF;;IAExF,4FAA4F;;IAE5F;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,0FAI/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,6DAA+B,CAAA;AAE7D;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,sCAAsC,CAAA"}

package/dist/infra-setup.js

@@ -0,0 +1,66 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Infrastructure-setup tracking. A small per-workspace status projection carried
+// on the workspace snapshot so the SPA can nag (a loud banner) when a workspace
+// runs on a deployment that REQUIRES a piece of infrastructure to be configured
+// but the operator hasn't defined it yet. Deliberately an explicit tri-state per
+// area (rather than an inferred boolean/absence) so "the operator never made a
+// decision" (`not_defined`) is tracked distinctly from "this runtime doesn't need
+// it" (`not_applicable`) and "it's set up" (`configured`).
+//
+// Computed server-side (WorkspaceController) from whatever each facade actually
+// wired, so it is runtime-symmetric by construction and needs no persistence:
+//   - ephemeral environments — the environment provider connection (all runtimes
+//     that wire the environments integration). Unset ⇒ testing agents can't run.
+//   - agent executor — the self-hosted runner-pool connection. Only the remote
+//     Node facade delegates container agents to a pool (Cloudflare has built-in
+//     per-run containers, local runs them on the host), so this is `not_applicable`
+//     everywhere except an unconfigured Node deployment. Unset ⇒ NO agents can run.
+//   - binary storage — the per-account content-storage backend. Every facade wires an
+//     artifact-store resolver, so this is effectively `configured`/`not_defined`, not
+//     `not_applicable`: local defaults to a filesystem store and Cloudflare with an
+//     `ARTIFACT_BUCKET` binding defaults to R2 (both ⇒ `configured`), while the Node
+//     facade defaults to `off` AND a Cloudflare deployment WITHOUT that binding also
+//     resolves nothing (both ⇒ `not_defined`). Unset ⇒ screenshot / reference-image
+//     storage (the UI-tester + visual-confirmation gate) is off.
+// ---------------------------------------------------------------------------
+/**
+ * The configuration state of one infrastructure area for a workspace:
+ *  - `not_defined`    — the deployment can use it, but the operator hasn't set it up
+ *                       (the banner-worthy state).
+ *  - `configured`     — a connection / backend is defined.
+ *  - `not_applicable` — this runtime doesn't need it (the integration isn't wired),
+ *                       so there is nothing to nag about.
+ */
+export const infraSetupStatusSchema = v.picklist(['not_defined', 'configured', 'not_applicable']);
+/** The per-area infrastructure-setup status projection carried on the snapshot. */
+export const infraSetupSchema = v.object({
+    /** Ephemeral test environments (deployer / provisioning). Relevant on every runtime. */
+    ephemeralEnvironments: infraSetupStatusSchema,
+    /** The container agent executor (self-hosted runner pool). Relevant only on remote Node. */
+    agentExecutor: infraSetupStatusSchema,
+    /**
+     * Binary/object storage for UI screenshots + reference images. Every facade wires an
+     * artifact-store resolver, so this is `configured`/`not_defined` on every runtime — not just
+     * remote Node: a Cloudflare deployment WITHOUT an `ARTIFACT_BUCKET` binding (or any account
+     * that selected no backend) reads `not_defined` too.
+     */
+    binaryStorage: infraSetupStatusSchema,
+});
+/** The infrastructure areas the setup banner surfaces (leaf names mirror {@link infraSetupSchema}). */
+export const infraSetupAreaSchema = v.picklist([
+    'ephemeralEnvironments',
+    'agentExecutor',
+    'binaryStorage',
+]);
+/** Every infra-setup area, as a plain readonly tuple (the source of truth for iteration). */
+export const INFRA_SETUP_AREAS = infraSetupAreaSchema.options;
+/**
+ * The `localStorage` key under which the SPA's `InfraSetupBanner` persists its PERMANENT,
+ * per-user "don't notify me again" dismissals ({@link InfraSetupArea}[] keyed by user id).
+ * Lives in this dependency-free contracts package — rather than only inside the Vue component —
+ * so the SPA and the e2e suite (which seeds the same key to suppress the banner) share ONE
+ * source of truth and can't drift.
+ */
+export const INFRA_SETUP_DISMISSED_STORAGE_KEY = 'cat-factory:infra-setup-dismissed';
+//# sourceMappingURL=infra-setup.js.map

package/dist/infra-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-setup.js","sourceRoot":"","sources":["../src/infra-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,2DAA2D;AAC3D,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,iFAAiF;AACjF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,oFAAoF;AACpF,oFAAoF;AACpF,sFAAsF;AACtF,sFAAsF;AACtF,oFAAoF;AACpF,qFAAqF;AACrF,qFAAqF;AACrF,oFAAoF;AACpF,iEAAiE;AACjE,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAGjG,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,wFAAwF;IACxF,qBAAqB,EAAE,sBAAsB;IAC7C,4FAA4F;IAC5F,aAAa,EAAE,sBAAsB;IACrC;;;;;OAKG;IACH,aAAa,EAAE,sBAAsB;CACtC,CAAC,CAAA;AAGF,uGAAuG;AACvG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC7C,uBAAuB;IACvB,eAAe;IACf,eAAe;CAChB,CAAC,CAAA;AAGF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,mCAAmC,CAAA"}