@cat-factory/contracts 0.32.0 → 0.33.0

package/dist/index.d.ts

@@ -40,6 +40,7 @@ export * from './slack.js';
 export * from './observability.js';
 export * from './incident-enrichment.js';
 export * from './accountSettings.js';
+export * from './localSettings.js';
 export * from './recurring.js';
 export * from './tracker.js';
 export * from './vendor-credentials.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,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,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,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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,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,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,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"}

package/dist/index.js

@@ -40,6 +40,7 @@ export * from './slack.js';
 export * from './observability.js';
 export * from './incident-enrichment.js';
 export * from './accountSettings.js';
+export * from './localSettings.js';
 export * from './recurring.js';
 export * from './tracker.js';
 export * from './vendor-credentials.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,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,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,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,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,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,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,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"}

package/dist/localSettings.d.ts

@@ -0,0 +1,75 @@
+import * as v from 'valibot';
+/**
+ * Warm-container-pool sizing (the local Docker-family runner). `size: 0` ⇒ pooling OFF —
+ * every run cold-starts its own container, the classic behaviour. `> 0` keeps that many
+ * idle harness containers warm and re-leases one (preferring repo affinity) to each run.
+ */
+export declare const localPoolSettingsSchema: v.ObjectSchema<{
+    /** Max idle warm containers kept for re-lease. 0 disables pooling (cold-start per run). */
+    readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+    /** Containers pre-warmed when the service starts (clamped to `max`). */
+    readonly minWarm: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+    /** Hard cap on total containers (leased + idle). `null` ⇒ defaults to `size`. */
+    readonly max: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 100, undefined>]>, undefined>, null>;
+    /** How long an idle pooled container is kept before eviction (ms). */
+    readonly idleTtlMs: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 600000>;
+}, undefined>;
+export type LocalPoolSettings = v.InferOutput<typeof localPoolSettingsSchema>;
+/**
+ * Per-repo checkout-reuse knobs, forwarded into the harness container as env. When the
+ * warm pool re-leases a container that already holds the run's repo, the harness reuses
+ * its `<workspaceRoot>/<owner>/<repo>` checkout (clean-sweep + fetch + switch branch)
+ * instead of cloning fresh; `cleanKeep` are the dep-cache dirs that sweep preserves.
+ */
+export declare const localCheckoutSettingsSchema: v.ObjectSchema<{
+    /** Absolute in-container dir the reused per-repo checkout lives under. */
+    readonly workspaceRoot: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.RegexAction<string, "workspaceRoot must be an absolute (POSIX) path, e.g. /workspace">]>, "/workspace">;
+    /** Dep-cache directories the per-run clean sweep keeps (so deps aren't reinstalled). */
+    readonly cleanKeep: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>, readonly ["node_modules", ".venv", "target", ".gradle", ".pnpm-store"]>;
+}, undefined>;
+export type LocalCheckoutSettings = v.InferOutput<typeof localCheckoutSettingsSchema>;
+/** The full local-mode settings blob. Every field defaults, so `{}` parses to defaults. */
+export declare const localSettingsSchema: v.ObjectSchema<{
+    readonly pool: v.OptionalSchema<v.ObjectSchema<{
+        /** Max idle warm containers kept for re-lease. 0 disables pooling (cold-start per run). */
+        readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+        /** Containers pre-warmed when the service starts (clamped to `max`). */
+        readonly minWarm: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+        /** Hard cap on total containers (leased + idle). `null` ⇒ defaults to `size`. */
+        readonly max: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 100, undefined>]>, undefined>, null>;
+        /** How long an idle pooled container is kept before eviction (ms). */
+        readonly idleTtlMs: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 600000>;
+    }, undefined>, {}>;
+    readonly checkout: v.OptionalSchema<v.ObjectSchema<{
+        /** Absolute in-container dir the reused per-repo checkout lives under. */
+        readonly workspaceRoot: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.RegexAction<string, "workspaceRoot must be an absolute (POSIX) path, e.g. /workspace">]>, "/workspace">;
+        /** Dep-cache directories the per-run clean sweep keeps (so deps aren't reinstalled). */
+        readonly cleanKeep: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>, readonly ["node_modules", ".venv", "target", ".gradle", ".pnpm-store"]>;
+    }, undefined>, {}>;
+}, undefined>;
+export type LocalSettings = v.InferOutput<typeof localSettingsSchema>;
+/** Built-in config used when no row exists yet (pooling off, harness defaults). */
+export declare const DEFAULT_LOCAL_SETTINGS: LocalSettings;
+/** Parse + fully-default a (possibly partial / absent) stored settings blob. */
+export declare function parseLocalSettings(raw: unknown): LocalSettings;
+/** Admin write: the full settings blob fully replaces the stored config. */
+export declare const updateLocalSettingsSchema: v.ObjectSchema<{
+    readonly pool: v.OptionalSchema<v.ObjectSchema<{
+        /** Max idle warm containers kept for re-lease. 0 disables pooling (cold-start per run). */
+        readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+        /** Containers pre-warmed when the service starts (clamped to `max`). */
+        readonly minWarm: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 50, undefined>]>, 0>;
+        /** Hard cap on total containers (leased + idle). `null` ⇒ defaults to `size`. */
+        readonly max: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MaxValueAction<number, 100, undefined>]>, undefined>, null>;
+        /** How long an idle pooled container is kept before eviction (ms). */
+        readonly idleTtlMs: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 600000>;
+    }, undefined>, {}>;
+    readonly checkout: v.OptionalSchema<v.ObjectSchema<{
+        /** Absolute in-container dir the reused per-repo checkout lives under. */
+        readonly workspaceRoot: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.RegexAction<string, "workspaceRoot must be an absolute (POSIX) path, e.g. /workspace">]>, "/workspace">;
+        /** Dep-cache directories the per-run clean sweep keeps (so deps aren't reinstalled). */
+        readonly cleanKeep: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>, readonly ["node_modules", ".venv", "target", ".gradle", ".pnpm-store"]>;
+    }, undefined>, {}>;
+}, undefined>;
+export type UpdateLocalSettingsInput = v.InferOutput<typeof updateLocalSettingsSchema>;
+//# sourceMappingURL=localSettings.d.ts.map

package/dist/localSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localSettings.d.ts","sourceRoot":"","sources":["../src/localSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAgB5B;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;IAClC,2FAA2F;;IAE3F,wEAAwE;;IAExE,iFAAiF;;IAEjF,sEAAsE;;aAEtE,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;IACtC,0EAA0E;;IAU1E,wFAAwF;;aAQxF,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB;;QAxC9B,2FAA2F;;QAE3F,wEAAwE;;QAExE,iFAAiF;;QAEjF,sEAAsE;;;;QAYtE,0EAA0E;;QAU1E,wFAAwF;;;aAexF,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,EAAE,aAAgD,CAAA;AAErF,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB;;QAvDpC,2FAA2F;;QAE3F,wEAAwE;;QAExE,iFAAiF;;QAEjF,sEAAsE;;;;QAYtE,0EAA0E;;QAU1E,wFAAwF;;;aA2B9B,CAAA;AAC5D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/localSettings.js

@@ -0,0 +1,60 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Local-mode operational config, moved out of env vars into a single DB row (a
+// per-DEPLOYMENT singleton — local mode is one developer's machine, so there is no
+// per-account/per-workspace scoping). It is LOCAL-MODE-ONLY: the warm-container pool +
+// per-repo checkout reuse are differentiators of the local facade's Docker/Podman/…
+// runner, so this has NO Cloudflare/D1 mirror (the symmetry rule's runtime-specific
+// carve-out). Surfaced through a dedicated local-mode settings panel rather than the
+// account Deployment-settings panel, because local mode runs with the auth gate OPEN
+// (no signed-in admin account to hang it on). There are no secrets here, so the read
+// view is the plain config.
+// ---------------------------------------------------------------------------
+const nonNegInt = v.pipe(v.number(), v.integer(), v.minValue(0));
+/**
+ * Warm-container-pool sizing (the local Docker-family runner). `size: 0` ⇒ pooling OFF —
+ * every run cold-starts its own container, the classic behaviour. `> 0` keeps that many
+ * idle harness containers warm and re-leases one (preferring repo affinity) to each run.
+ */
+export const localPoolSettingsSchema = v.object({
+    /** Max idle warm containers kept for re-lease. 0 disables pooling (cold-start per run). */
+    size: v.optional(v.pipe(nonNegInt, v.maxValue(50)), 0),
+    /** Containers pre-warmed when the service starts (clamped to `max`). */
+    minWarm: v.optional(v.pipe(nonNegInt, v.maxValue(50)), 0),
+    /** Hard cap on total containers (leased + idle). `null` ⇒ defaults to `size`. */
+    max: v.optional(v.nullable(v.pipe(nonNegInt, v.maxValue(100))), null),
+    /** How long an idle pooled container is kept before eviction (ms). */
+    idleTtlMs: v.optional(nonNegInt, 600_000),
+});
+/**
+ * Per-repo checkout-reuse knobs, forwarded into the harness container as env. When the
+ * warm pool re-leases a container that already holds the run's repo, the harness reuses
+ * its `<workspaceRoot>/<owner>/<repo>` checkout (clean-sweep + fetch + switch branch)
+ * instead of cloning fresh; `cleanKeep` are the dep-cache dirs that sweep preserves.
+ */
+export const localCheckoutSettingsSchema = v.object({
+    /** Absolute in-container dir the reused per-repo checkout lives under. */
+    workspaceRoot: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1), v.regex(/^\//, 'workspaceRoot must be an absolute (POSIX) path, e.g. /workspace')), '/workspace'),
+    /** Dep-cache directories the per-run clean sweep keeps (so deps aren't reinstalled). */
+    cleanKeep: v.optional(v.array(v.pipe(v.string(), v.trim(), v.minLength(1))), [
+        'node_modules',
+        '.venv',
+        'target',
+        '.gradle',
+        '.pnpm-store',
+    ]),
+});
+/** The full local-mode settings blob. Every field defaults, so `{}` parses to defaults. */
+export const localSettingsSchema = v.object({
+    pool: v.optional(localPoolSettingsSchema, {}),
+    checkout: v.optional(localCheckoutSettingsSchema, {}),
+});
+/** Built-in config used when no row exists yet (pooling off, harness defaults). */
+export const DEFAULT_LOCAL_SETTINGS = v.parse(localSettingsSchema, {});
+/** Parse + fully-default a (possibly partial / absent) stored settings blob. */
+export function parseLocalSettings(raw) {
+    return v.parse(localSettingsSchema, raw ?? {});
+}
+/** Admin write: the full settings blob fully replaces the stored config. */
+export const updateLocalSettingsSchema = localSettingsSchema;
+//# sourceMappingURL=localSettings.js.map

package/dist/localSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localSettings.js","sourceRoot":"","sources":["../src/localSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,+EAA+E;AAC/E,mFAAmF;AACnF,uFAAuF;AACvF,oFAAoF;AACpF,oFAAoF;AACpF,qFAAqF;AACrF,qFAAqF;AACrF,qFAAqF;AACrF,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,2FAA2F;IAC3F,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,wEAAwE;IACxE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,iFAAiF;IACjF,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACrE,sEAAsE;IACtE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC1C,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,0EAA0E;IAC1E,aAAa,EAAE,CAAC,CAAC,QAAQ,CACvB,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACd,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,iEAAiE,CAAC,CAClF,EACD,YAAY,CACb;IACD,wFAAwF;IACxF,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QAC3E,cAAc;QACd,OAAO;QACP,QAAQ;QACR,SAAS;QACT,aAAa;KACd,CAAC;CACH,CAAC,CAAA;AAGF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,EAAE,EAAE,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,EAAE,EAAE,CAAC;CACtD,CAAC,CAAA;AAGF,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAkB,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAA;AAErF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",