@cat-factory/contracts 0.100.0 → 0.101.1

package/dist/index.d.ts

@@ -65,5 +65,6 @@ export * from './sandbox.js';
 export * from './workspace-settings.js';
 export * from './kaizen.js';
 export * from './initiative.js';
+export * from './initiative-preset.js';
 export * from './routes/index.js';
 //# sourceMappingURL=index.d.ts.map

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,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,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,oBAAoB,CAAA;AAClC,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,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,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,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,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,iBAAiB,CAAA;AAC/B,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,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,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,oBAAoB,CAAA;AAClC,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,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,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,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,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,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/dist/index.js

@@ -65,5 +65,6 @@ export * from './sandbox.js';
 export * from './workspace-settings.js';
 export * from './kaizen.js';
 export * from './initiative.js';
+export * from './initiative-preset.js';
 export * from './routes/index.js';
 //# sourceMappingURL=index.js.map

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,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,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,oBAAoB,CAAA;AAClC,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,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,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,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,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,iBAAiB,CAAA;AAC/B,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,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,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,oBAAoB,CAAA;AAClC,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,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,2BAA2B,CAAA;AACzC,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,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,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,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/dist/initiative-preset.d.ts

@@ -0,0 +1,258 @@
+import * as v from 'valibot';
+import { type InitiativePresetInputs } from './initiative.js';
+/**
+ * How a preset field is rendered/collected. The first six mirror {@link ProviderConfigField}'s
+ * types exactly; `checkbox-group` (a multi-select, value `string[]`) and `path` (a repo-relative
+ * directory, {@link isSafeRepoDirPath}-validated) are the two additions the preset form needs.
+ */
+export declare const initiativePresetFieldTypeSchema: v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>;
+export type InitiativePresetFieldType = v.InferOutput<typeof initiativePresetFieldTypeSchema>;
+/**
+ * Single-condition visibility for a field: it renders only when the referenced field's value
+ * matches. `equals` compares a scalar value; `includes` tests membership in a `checkbox-group`
+ * value (the per-doc-type subfolder case — "show `diagramsDir` only when `docTypes` includes
+ * `diagrams`"). Deliberately ONE condition — resist growing this into a recursive schema
+ * renderer (that is the descriptor-forms initiative's separate line item).
+ */
+export declare const initiativePresetShowWhenSchema: v.ObjectSchema<{
+    /** The `key` of the field whose value gates this one's visibility. */
+    readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    /**
+     * Show when the referenced scalar value equals this. A union so `equals` can gate a
+     * `checkbox` (boolean) or `number` field, not only a `select`/`text` string — the
+     * comparison is strict, so the type must match the referenced field's value.
+     */
+    readonly equals: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+    /** Show when the referenced `checkbox-group` value includes this. */
+    readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type InitiativePresetShowWhen = v.InferOutput<typeof initiativePresetShowWhenSchema>;
+/** One value a preset needs, rendered as a single form field. */
+export declare const initiativePresetFieldSchema: v.ObjectSchema<{
+    /** Stable key the value is stored/sent under (e.g. `docTypes`, `docsRoot`). */
+    readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    /** Human label for the form field (backend-supplied English). */
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    /** Optional helper text shown under the field. */
+    readonly help: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Optional input placeholder. */
+    readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Whether the value is required (absent ⇒ optional). A hidden (`showWhen`) field is never required. */
+    readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Field type; absent is treated as `text`. */
+    readonly type: v.OptionalSchema<v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>, undefined>;
+    /** Choices for a `select` / `checkbox-group` field. */
+    readonly options: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly value: v.StringSchema<undefined>;
+        readonly label: v.StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+    /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`); the form falls back to it when blank. */
+    readonly default: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** The multi-select default for a `checkbox-group` field. */
+    readonly defaultValues: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Single-condition visibility; absent ⇒ always shown. */
+    readonly showWhen: v.OptionalSchema<v.ObjectSchema<{
+        /** The `key` of the field whose value gates this one's visibility. */
+        readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        /**
+         * Show when the referenced scalar value equals this. A union so `equals` can gate a
+         * `checkbox` (boolean) or `number` field, not only a `select`/`text` string — the
+         * comparison is strict, so the type must match the referenced field's value.
+         */
+        readonly equals: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+        /** Show when the referenced `checkbox-group` value includes this. */
+        readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type InitiativePresetField = v.InferOutput<typeof initiativePresetFieldSchema>;
+/** Display metadata for a preset in the create-initiative picker. */
+export declare const initiativePresetPresentationSchema: v.ObjectSchema<{
+    /** Human label, e.g. `Documentation refresh`. */
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    /** Icon id (e.g. an `i-lucide-*` name). */
+    readonly icon: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    /** Accent colour (CSS hex/keyword). */
+    readonly color: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>;
+    /** One-line description shown in the picker. */
+    readonly description: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>;
+}, undefined>;
+export type InitiativePresetPresentation = v.InferOutput<typeof initiativePresetPresentationSchema>;
+/**
+ * The serialisable, SPA-facing description of a preset: everything the create-initiative
+ * modal needs to render the picker + form and start planning, attached to the workspace
+ * snapshot (the `customAgentKinds` precedent). The code hooks (`detect`/`seedPlan`/
+ * `promptAdditions`) live on the kernel registration, NOT here.
+ */
+export declare const initiativePresetDescriptorSchema: v.ObjectSchema<{
+    /** Stable preset id (e.g. `preset_generic`, `preset_docs_refresh`). */
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    readonly presentation: v.ObjectSchema<{
+        /** Human label, e.g. `Documentation refresh`. */
+        readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+        /** Icon id (e.g. an `i-lucide-*` name). */
+        readonly icon: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        /** Accent colour (CSS hex/keyword). */
+        readonly color: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>;
+        /** One-line description shown in the picker. */
+        readonly description: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>;
+    }, undefined>;
+    /** The form fields the user fills at create time (empty for the generic preset). */
+    readonly fields: v.ArraySchema<v.ObjectSchema<{
+        /** Stable key the value is stored/sent under (e.g. `docTypes`, `docsRoot`). */
+        readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+        /** Human label for the form field (backend-supplied English). */
+        readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        /** Optional helper text shown under the field. */
+        readonly help: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Optional input placeholder. */
+        readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Whether the value is required (absent ⇒ optional). A hidden (`showWhen`) field is never required. */
+        readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** Field type; absent is treated as `text`. */
+        readonly type: v.OptionalSchema<v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>, undefined>;
+        /** Choices for a `select` / `checkbox-group` field. */
+        readonly options: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly value: v.StringSchema<undefined>;
+            readonly label: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`); the form falls back to it when blank. */
+        readonly default: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** The multi-select default for a `checkbox-group` field. */
+        readonly defaultValues: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /** Single-condition visibility; absent ⇒ always shown. */
+        readonly showWhen: v.OptionalSchema<v.ObjectSchema<{
+            /** The `key` of the field whose value gates this one's visibility. */
+            readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            /**
+             * Show when the referenced scalar value equals this. A union so `equals` can gate a
+             * `checkbox` (boolean) or `number` field, not only a `select`/`text` string — the
+             * comparison is strict, so the type must match the referenced field's value.
+             */
+            readonly equals: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+            /** Show when the referenced `checkbox-group` value includes this. */
+            readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** The planning pipeline the SPA starts (e.g. `pl_initiative`, `pl_initiative_docs`). */
+    readonly planningPipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    /** `full` runs the interviewer; `skip` treats the form AS the interview (seeded qa). */
+    readonly interview: v.PicklistSchema<["full", "skip"], undefined>;
+    /** Default for the human-review opt-in (mapped to the gate-override seam at start). */
+    readonly humanReviewDefault: v.BooleanSchema<undefined>;
+    /** Best-practice prompt fragments applied by default (configurable via a form field). */
+    readonly defaultFragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+    /** Partial execution-policy overrides folded in at plan ingest. */
+    readonly policyDefaults: v.OptionalSchema<Omit<v.ObjectSchema<{
+        readonly maxConcurrent: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 20, undefined>]>;
+        readonly rules: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+            readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        }, undefined>, undefined>, readonly []>;
+        readonly defaultPipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+        readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["default", "strongest"], undefined>, "default">;
+    }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+        readonly entries: {
+            readonly maxConcurrent: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 20, undefined>]>, undefined>;
+            readonly rules: v.OptionalSchema<v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+                readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+                readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            }, undefined>, undefined>, readonly []>, undefined>;
+            readonly defaultPipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, undefined>;
+            readonly onMissingEstimate: v.OptionalSchema<v.OptionalSchema<v.PicklistSchema<["default", "strongest"], undefined>, "default">, undefined>;
+        };
+        readonly "~standard": v.StandardProps<{
+            maxConcurrent?: number | undefined;
+            rules?: {
+                pipelineId: string;
+                minComplexity?: number | undefined;
+                minRisk?: number | undefined;
+                minImpact?: number | undefined;
+            }[] | undefined;
+            defaultPipelineId?: string | undefined;
+            onMissingEstimate?: "default" | "strongest" | undefined;
+        }, {
+            maxConcurrent?: number | undefined;
+            rules?: {
+                pipelineId: string;
+                minComplexity?: number | undefined;
+                minRisk?: number | undefined;
+                minImpact?: number | undefined;
+            }[] | undefined;
+            defaultPipelineId?: string | undefined;
+            onMissingEstimate?: "default" | "strongest" | undefined;
+        }>;
+        readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+            maxConcurrent?: number | undefined;
+            rules?: {
+                pipelineId: string;
+                minComplexity?: number | undefined;
+                minRisk?: number | undefined;
+                minImpact?: number | undefined;
+            }[] | undefined;
+            defaultPipelineId?: string | undefined;
+            onMissingEstimate?: "default" | "strongest" | undefined;
+        }, v.ArrayIssue | v.IntegerIssue<number> | v.MaxLengthIssue<string, 80> | v.MaxValueIssue<number, 1> | v.MaxValueIssue<number, 20> | v.MinLengthIssue<string, 1> | v.MinValueIssue<number, 0> | v.MinValueIssue<number, 1> | v.NumberIssue | v.ObjectIssue | v.PicklistIssue | v.StringIssue>;
+        readonly "~types"?: {
+            readonly input: {
+                maxConcurrent?: number | undefined;
+                rules?: {
+                    pipelineId: string;
+                    minComplexity?: number | undefined;
+                    minRisk?: number | undefined;
+                    minImpact?: number | undefined;
+                }[] | undefined;
+                defaultPipelineId?: string | undefined;
+                onMissingEstimate?: "default" | "strongest" | undefined;
+            };
+            readonly output: {
+                maxConcurrent?: number | undefined;
+                rules?: {
+                    pipelineId: string;
+                    minComplexity?: number | undefined;
+                    minRisk?: number | undefined;
+                    minImpact?: number | undefined;
+                }[] | undefined;
+                defaultPipelineId?: string | undefined;
+                onMissingEstimate?: "default" | "strongest" | undefined;
+            };
+            readonly issue: v.ArrayIssue | v.IntegerIssue<number> | v.MaxLengthIssue<string, 80> | v.MaxValueIssue<number, 1> | v.MaxValueIssue<number, 20> | v.MinLengthIssue<string, 1> | v.MinValueIssue<number, 0> | v.MinValueIssue<number, 1> | v.NumberIssue | v.ObjectIssue | v.PicklistIssue | v.StringIssue;
+        } | undefined;
+    }, undefined>;
+    /**
+     * Whether this preset supports a repo-detection PREFILL probe (a `detect` hook is wired on
+     * the registration). Computed server-side when the snapshot is built (the `supportsTest`
+     * convention) so the SPA knows to call `POST …/initiative-presets/:id/probe`. Never blocks
+     * create — an unwired probe / GitHub simply falls back to the descriptor defaults.
+     */
+    readonly probe: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type InitiativePresetDescriptor = v.InferOutput<typeof initiativePresetDescriptorSchema>;
+/** Strictly parse a preset descriptor. Throws on shape violations. */
+export declare function parseInitiativePresetDescriptor(value: unknown): InitiativePresetDescriptor;
+/**
+ * Whether `path` is a SAFE repo-relative DIRECTORY (the `path`-field analogue of
+ * {@link isSafeDocPath}, minus the `.md` requirement). A preset `path` value is used verbatim
+ * as an in-repo placement dir the writers commit under, so it must not escape the repo: no `..`
+ * traversal, no absolute path (`/…` or a Windows drive), no backslash / NUL. An empty string is
+ * NOT a valid path (callers treat "unset" separately). A trailing slash is tolerated.
+ */
+export declare function isSafeRepoDirPath(path: string): boolean;
+/** Whether a field is visible given the current input values (its `showWhen` condition). */
+export declare function isPresetFieldVisible(field: InitiativePresetField, inputs: InitiativePresetInputs): boolean;
+/**
+ * Validate a filled preset form against its descriptor, returning a list of human-readable
+ * problems (EMPTY ⇒ valid). Pure + total (never throws), so the create controller can map a
+ * non-empty result to a single ValidationError. Enforces: no unknown keys, correct value type
+ * per field, required VISIBLE fields present (a required `checkbox` must be CHECKED — an
+ * unchecked `false` counts as unset), `select`/`checkbox-group` values drawn from the declared
+ * options, and `path` values that stay inside the repo ({@link isSafeRepoDirPath}). Hidden
+ * fields (failing `showWhen`) are not required and their stale values are ignored.
+ */
+export declare function validateInitiativePresetInputs(descriptor: InitiativePresetDescriptor, inputs: InitiativePresetInputs): string[];
+/** Strictly parse a bounded preset-inputs record. Throws on shape violations. */
+export declare function parseInitiativePresetInputs(value: unknown): InitiativePresetInputs;
+//# sourceMappingURL=initiative-preset.d.ts.map

package/dist/initiative-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiative-preset.d.ts","sourceRoot":"","sources":["../src/initiative-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,iBAAiB,CAAA;AAuBxB;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,yHAS1C,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;IACzC,sEAAsE;;IAEtE;;;;OAIG;;IAEH,qEAAqE;;aAErE,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAE3F,iEAAiE;AACjE,eAAO,MAAM,2BAA2B;IACtC,+EAA+E;;IAE/E,iEAAiE;;IAEjE,kDAAkD;;IAElD,kCAAkC;;IAElC,wGAAwG;;IAExG,+CAA+C;;IAE/C,uDAAuD;;;;;IAEvD,6GAA6G;;IAE7G,6DAA6D;;IAE7D,0DAA0D;;QAjC1D,sEAAsE;;QAEtE;;;;WAIG;;QAEH,qEAAqE;;;aA2BrE,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF,qEAAqE;AACrE,eAAO,MAAM,kCAAkC;IAC7C,iDAAiD;;IAEjD,2CAA2C;;IAE3C,uCAAuC;;IAEvC,gDAAgD;;aAEhD,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;IAC3C,uEAAuE;;;QAlBvE,iDAAiD;;QAEjD,2CAA2C;;QAE3C,uCAAuC;;QAEvC,gDAAgD;;;IAehD,oFAAoF;;QA9CpF,+EAA+E;;QAE/E,iEAAiE;;QAEjE,kDAAkD;;QAElD,kCAAkC;;QAElC,wGAAwG;;QAExG,+CAA+C;;QAE/C,uDAAuD;;;;;QAEvD,6GAA6G;;QAE7G,6DAA6D;;QAE7D,0DAA0D;;YAjC1D,sEAAsE;;YAEtE;;;;eAIG;;YAEH,qEAAqE;;;;IAuDrE,yFAAyF;;IAEzF,wFAAwF;;IAExF,uFAAuF;;IAEvF,yFAAyF;;IAEzF,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEnE;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAE/F,sEAAsE;AACtE,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAE1F;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAQT;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,CA8CV;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAElF"}

package/dist/initiative-preset.js

@@ -0,0 +1,228 @@
+import * as v from 'valibot';
+import { initiativeExecutionPolicySchema, initiativePresetInputsSchema, } from './initiative.js';
+// ---------------------------------------------------------------------------
+// Initiative-preset wire contracts.
+//
+// An initiative PRESET is more than a pipeline: it bundles (a) its own FORM the user
+// fills at create time — rendered generically by the SPA from this backend-supplied
+// descriptor, zero frontend changes per preset — (b) a planning-pipeline binding
+// (skip the interviewer when the form IS the interview), (c) execution-policy /
+// fragment / human-review defaults, and (d) code hooks (a repo-detection prefill
+// probe, a plan post-processor) that live on the KERNEL registration, not here (this
+// file is the serialisable, SPA-facing subset). See
+// `docs/initiatives/initiative-presets-and-docs-refresh.md` and the kernel
+// `initiative-preset-registry.ts`.
+//
+// The field descriptor extends the `ProviderConfigField` family with the two shapes a
+// preset form needs that a flat provider form did not: `checkbox-group` (a multi-select
+// whose value is `string[]`) and `path` (a repo-relative directory), plus single-condition
+// `showWhen` visibility (a per-doc-type subfolder shown only when that type is checked).
+// Descriptor labels are backend-supplied English (the `describeConfig` convention); only
+// the surrounding chrome is i18n.
+// ---------------------------------------------------------------------------
+/**
+ * How a preset field is rendered/collected. The first six mirror {@link ProviderConfigField}'s
+ * types exactly; `checkbox-group` (a multi-select, value `string[]`) and `path` (a repo-relative
+ * directory, {@link isSafeRepoDirPath}-validated) are the two additions the preset form needs.
+ */
+export const initiativePresetFieldTypeSchema = v.picklist([
+    'text',
+    'password',
+    'select',
+    'number',
+    'checkbox',
+    'textarea',
+    'checkbox-group',
+    'path',
+]);
+/**
+ * Single-condition visibility for a field: it renders only when the referenced field's value
+ * matches. `equals` compares a scalar value; `includes` tests membership in a `checkbox-group`
+ * value (the per-doc-type subfolder case — "show `diagramsDir` only when `docTypes` includes
+ * `diagrams`"). Deliberately ONE condition — resist growing this into a recursive schema
+ * renderer (that is the descriptor-forms initiative's separate line item).
+ */
+export const initiativePresetShowWhenSchema = v.object({
+    /** The `key` of the field whose value gates this one's visibility. */
+    key: v.pipe(v.string(), v.minLength(1)),
+    /**
+     * Show when the referenced scalar value equals this. A union so `equals` can gate a
+     * `checkbox` (boolean) or `number` field, not only a `select`/`text` string — the
+     * comparison is strict, so the type must match the referenced field's value.
+     */
+    equals: v.optional(v.union([v.string(), v.boolean(), v.number()])),
+    /** Show when the referenced `checkbox-group` value includes this. */
+    includes: v.optional(v.string()),
+});
+/** One value a preset needs, rendered as a single form field. */
+export const initiativePresetFieldSchema = v.object({
+    /** Stable key the value is stored/sent under (e.g. `docTypes`, `docsRoot`). */
+    key: v.pipe(v.string(), v.minLength(1), v.maxLength(80)),
+    /** Human label for the form field (backend-supplied English). */
+    label: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** Optional helper text shown under the field. */
+    help: v.optional(v.string()),
+    /** Optional input placeholder. */
+    placeholder: v.optional(v.string()),
+    /** Whether the value is required (absent ⇒ optional). A hidden (`showWhen`) field is never required. */
+    required: v.optional(v.boolean()),
+    /** Field type; absent is treated as `text`. */
+    type: v.optional(initiativePresetFieldTypeSchema),
+    /** Choices for a `select` / `checkbox-group` field. */
+    options: v.optional(v.array(v.object({ value: v.string(), label: v.string() }))),
+    /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`); the form falls back to it when blank. */
+    default: v.optional(v.string()),
+    /** The multi-select default for a `checkbox-group` field. */
+    defaultValues: v.optional(v.array(v.string())),
+    /** Single-condition visibility; absent ⇒ always shown. */
+    showWhen: v.optional(initiativePresetShowWhenSchema),
+});
+/** Display metadata for a preset in the create-initiative picker. */
+export const initiativePresetPresentationSchema = v.object({
+    /** Human label, e.g. `Documentation refresh`. */
+    label: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80)),
+    /** Icon id (e.g. an `i-lucide-*` name). */
+    icon: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** Accent colour (CSS hex/keyword). */
+    color: v.pipe(v.string(), v.minLength(1), v.maxLength(40)),
+    /** One-line description shown in the picker. */
+    description: v.pipe(v.string(), v.maxLength(500)),
+});
+/**
+ * The serialisable, SPA-facing description of a preset: everything the create-initiative
+ * modal needs to render the picker + form and start planning, attached to the workspace
+ * snapshot (the `customAgentKinds` precedent). The code hooks (`detect`/`seedPlan`/
+ * `promptAdditions`) live on the kernel registration, NOT here.
+ */
+export const initiativePresetDescriptorSchema = v.object({
+    /** Stable preset id (e.g. `preset_generic`, `preset_docs_refresh`). */
+    id: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80)),
+    presentation: initiativePresetPresentationSchema,
+    /** The form fields the user fills at create time (empty for the generic preset). */
+    fields: v.array(initiativePresetFieldSchema),
+    /** The planning pipeline the SPA starts (e.g. `pl_initiative`, `pl_initiative_docs`). */
+    planningPipelineId: v.pipe(v.string(), v.minLength(1)),
+    /** `full` runs the interviewer; `skip` treats the form AS the interview (seeded qa). */
+    interview: v.picklist(['full', 'skip']),
+    /** Default for the human-review opt-in (mapped to the gate-override seam at start). */
+    humanReviewDefault: v.boolean(),
+    /** Best-practice prompt fragments applied by default (configurable via a form field). */
+    defaultFragmentIds: v.optional(v.array(v.string()), []),
+    /** Partial execution-policy overrides folded in at plan ingest. */
+    policyDefaults: v.optional(v.partial(initiativeExecutionPolicySchema)),
+    /**
+     * Whether this preset supports a repo-detection PREFILL probe (a `detect` hook is wired on
+     * the registration). Computed server-side when the snapshot is built (the `supportsTest`
+     * convention) so the SPA knows to call `POST …/initiative-presets/:id/probe`. Never blocks
+     * create — an unwired probe / GitHub simply falls back to the descriptor defaults.
+     */
+    probe: v.optional(v.boolean()),
+});
+/** Strictly parse a preset descriptor. Throws on shape violations. */
+export function parseInitiativePresetDescriptor(value) {
+    return v.parse(initiativePresetDescriptorSchema, value);
+}
+// ---------------------------------------------------------------------------
+// Path safety + input validation (pure — shared by the create-flow validation).
+// ---------------------------------------------------------------------------
+/**
+ * Whether `path` is a SAFE repo-relative DIRECTORY (the `path`-field analogue of
+ * {@link isSafeDocPath}, minus the `.md` requirement). A preset `path` value is used verbatim
+ * as an in-repo placement dir the writers commit under, so it must not escape the repo: no `..`
+ * traversal, no absolute path (`/…` or a Windows drive), no backslash / NUL. An empty string is
+ * NOT a valid path (callers treat "unset" separately). A trailing slash is tolerated.
+ */
+export function isSafeRepoDirPath(path) {
+    const p = path.trim();
+    if (!p || p.length > 300)
+        return false;
+    if (p.startsWith('/') || /^[a-zA-Z]:/.test(p))
+        return false;
+    if (p.includes('\\') || p.includes('\0'))
+        return false;
+    return !p.split('/').some((segment) => segment === '..');
+}
+/** Whether a field is visible given the current input values (its `showWhen` condition). */
+export function isPresetFieldVisible(field, inputs) {
+    const cond = field.showWhen;
+    if (!cond)
+        return true;
+    const value = inputs[cond.key];
+    if (cond.equals !== undefined)
+        return value === cond.equals;
+    if (cond.includes !== undefined)
+        return Array.isArray(value) && value.includes(cond.includes);
+    // A `showWhen` with neither predicate is a malformed condition — treat as always visible.
+    return true;
+}
+/** Whether a filled value matches the field's declared type (structural, pre-semantic check). */
+function valueMatchesFieldType(field, value) {
+    switch (field.type) {
+        case 'checkbox-group':
+            return Array.isArray(value);
+        case 'checkbox':
+            return typeof value === 'boolean';
+        case 'number':
+            return typeof value === 'number';
+        default:
+            // text / password / select / textarea / path (and the untyped default) are strings.
+            return typeof value === 'string';
+    }
+}
+/**
+ * Validate a filled preset form against its descriptor, returning a list of human-readable
+ * problems (EMPTY ⇒ valid). Pure + total (never throws), so the create controller can map a
+ * non-empty result to a single ValidationError. Enforces: no unknown keys, correct value type
+ * per field, required VISIBLE fields present (a required `checkbox` must be CHECKED — an
+ * unchecked `false` counts as unset), `select`/`checkbox-group` values drawn from the declared
+ * options, and `path` values that stay inside the repo ({@link isSafeRepoDirPath}). Hidden
+ * fields (failing `showWhen`) are not required and their stale values are ignored.
+ */
+export function validateInitiativePresetInputs(descriptor, inputs) {
+    const problems = [];
+    const byKey = new Map(descriptor.fields.map((f) => [f.key, f]));
+    for (const key of Object.keys(inputs)) {
+        if (!byKey.has(key))
+            problems.push(`Unknown field "${key}".`);
+    }
+    for (const field of descriptor.fields) {
+        const visible = isPresetFieldVisible(field, inputs);
+        const value = inputs[field.key];
+        // A checkbox is "present" only when checked: a required checkbox means "must be checked",
+        // so an unchecked (`false`) box counts as unset and fails the required check below.
+        const present = value !== undefined &&
+            !(typeof value === 'string' && value.trim() === '') &&
+            !(Array.isArray(value) && value.length === 0) &&
+            value !== false;
+        if (!visible)
+            continue;
+        if (!present) {
+            if (field.required)
+                problems.push(`Field "${field.key}" is required.`);
+            continue;
+        }
+        if (!valueMatchesFieldType(field, value)) {
+            problems.push(`Field "${field.key}" has the wrong type for a ${field.type ?? 'text'} field.`);
+            continue;
+        }
+        const optionValues = new Set((field.options ?? []).map((o) => o.value));
+        if (field.type === 'select' && optionValues.size > 0 && !optionValues.has(value)) {
+            problems.push(`Field "${field.key}" has a value outside its options.`);
+        }
+        if (field.type === 'checkbox-group' && optionValues.size > 0) {
+            for (const entry of value) {
+                if (!optionValues.has(entry))
+                    problems.push(`Field "${field.key}" has an option "${entry}" outside its choices.`);
+            }
+        }
+        if (field.type === 'path' && !isSafeRepoDirPath(value)) {
+            problems.push(`Field "${field.key}" must be a relative path inside the repo (no "..", absolute, or backslash segments).`);
+        }
+    }
+    return problems;
+}
+/** Strictly parse a bounded preset-inputs record. Throws on shape violations. */
+export function parseInitiativePresetInputs(value) {
+    return v.parse(initiativePresetInputsSchema, value);
+}
+//# sourceMappingURL=initiative-preset.js.map

package/dist/initiative-preset.js.map

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