@cat-factory/contracts 0.229.0 → 0.230.1

package/dist/entities.d.ts

@@ -223,7 +223,7 @@ export declare const blockSchema: v.ObjectSchema<{
         readonly prNumber: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
         readonly prUrl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
         readonly reviewFocus: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
-        readonly custom: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>;
+        readonly custom: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>;
     }, undefined>, undefined>, undefined>;
     /**
      * Whether this task is purely TECHNICAL (a refactor / non-functional / internal change

package/dist/errors.js

@@ -171,7 +171,7 @@ export const CONFLICT_REASONS = [
     // useful to a headless integration: a redelivered webhook reads it as "already filed" and
     // follows the existing task instead of filing a duplicate.
     'ticket_already_linked',
-    // A caller tried to resolve a run's PRE-TOKEN INPUT GATE that is not (or is no longer) parked
+    // A caller tried to resolve a run's PRE-DISPATCH INPUT GATE that is not (or is no longer) parked
     // on it: the gate passed, the workspace has it off, or another surface already answered it.
     // The remedy is "nothing to do here": the SPA refreshes the run rather than re-offering a
     // decision that has already been taken.

package/dist/errors.js.map

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

package/dist/execution.d.ts

@@ -2409,7 +2409,7 @@ export type IntakeOrigin = v.InferOutput<typeof intakeOriginSchema>;
  * pull request, so the human sees a real diff on a real branch, but nothing merges — neither the
  * `merger` step's auto-merge nor the manual merge endpoint.
  *
- * The PR is deliberately still opened. The deliverable a non-engineer needs to SEE is the diff,
+ * The PR is deliberately still opened. The deliverable a non-developer initiator needs to SEE is the diff,
  * and withholding the push would leave them reading prose about work they cannot inspect; what
  * makes the mode a sandbox is that the change cannot reach the default branch, not that it stays
  * invisible.
@@ -4309,7 +4309,7 @@ export declare const executionInstanceSchema: v.ObjectSchema<{
         }, undefined>, undefined>;
     }, undefined>, undefined>;
     /**
-     * The PRE-TOKEN INPUT GATE's verdict on the task this run implements (see
+     * The PRE-DISPATCH INPUT GATE's verdict on the task this run implements (see
      * {@link runInputGateSchema}): the structural check of the authored input that runs before
      * the first agent step is dispatched, so a task nobody could act on parks having spent no
      * tokens at all.

package/dist/execution.js

@@ -1207,7 +1207,7 @@ export const intakeOriginSchema = v.picklist(['ui', 'public-api']);
  * pull request, so the human sees a real diff on a real branch, but nothing merges — neither the
  * `merger` step's auto-merge nor the manual merge endpoint.
  *
- * The PR is deliberately still opened. The deliverable a non-engineer needs to SEE is the diff,
+ * The PR is deliberately still opened. The deliverable a non-developer initiator needs to SEE is the diff,
  * and withholding the push would leave them reading prose about work they cannot inspect; what
  * makes the mode a sandbox is that the change cannot reach the default branch, not that it stays
  * invisible.
@@ -1382,7 +1382,7 @@ export const executionInstanceSchema = v.object({
      */
     diagnostics: v.optional(runDiagnosticsSchema),
     /**
-     * The PRE-TOKEN INPUT GATE's verdict on the task this run implements (see
+     * The PRE-DISPATCH INPUT GATE's verdict on the task this run implements (see
      * {@link runInputGateSchema}): the structural check of the authored input that runs before
      * the first agent step is dispatched, so a task nobody could act on parks having spent no
      * tokens at all.

package/dist/form-fields.d.ts

@@ -0,0 +1,203 @@
+import * as v from 'valibot';
+/** Bound on a field `key`, and on a key in a filled {@link descriptorFieldValuesSchema} bag. */
+export declare const DESCRIPTOR_FIELD_KEY_MAX = 80;
+/** Bound on a single string / string-array element value. */
+export declare const DESCRIPTOR_FIELD_VALUE_MAX = 2000;
+/** Bound on the number of elements in a `checkbox-group` (multi-value) answer. */
+export declare const DESCRIPTOR_FIELD_ARRAY_MAX = 50;
+/** One filled value: a scalar (`text`/`select`/`path`/…), a multi-select, a toggle, or a number. */
+export declare const descriptorFieldValueSchema: v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>;
+export type DescriptorFieldValue = v.InferOutput<typeof descriptorFieldValueSchema>;
+/** A filled descriptor form: a bounded map from field `key` to its value. */
+export declare const descriptorFieldValuesSchema: v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+export type DescriptorFieldValues = v.InferOutput<typeof descriptorFieldValuesSchema>;
+/**
+ * How a field is rendered and collected. The first six mirror `ProviderConfigField`'s types
+ * exactly; `checkbox-group` (a multi-select, value `string[]`) and `path` (a repo-relative
+ * directory, {@link isSafeRepoDirPath}-validated) are the two the preset form added.
+ *
+ * A surface may admit a SUBSET (each declares its own picklist over these members) but never a
+ * member outside them: the renderer and the validators below switch over exactly this union.
+ */
+export declare const descriptorFieldTypeSchema: v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>;
+export type DescriptorFieldType = v.InferOutput<typeof descriptorFieldTypeSchema>;
+/**
+ * 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 ("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 descriptorFieldShowWhenSchema: 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 DescriptorFieldShowWhen = v.InferOutput<typeof descriptorFieldShowWhenSchema>;
+/** One choice of a `select` / `checkbox-group` field. */
+export declare const descriptorFieldOptionSchema: v.ObjectSchema<{
+    /** The value stored when this choice is picked (an enum-stable string). */
+    readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    /** The caption shown in the form, and rendered in place of the value in prose. */
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+}, undefined>;
+export type DescriptorFieldOption = v.InferOutput<typeof descriptorFieldOptionSchema>;
+/**
+ * Everything a descriptor field carries EXCEPT its `type`, which each surface narrows to its own
+ * admitted picklist. Spread into that surface's own `v.object({ ...descriptorFieldEntries, type })`
+ * so the shared bounds cannot drift per surface and a new shared attribute reaches both at once.
+ */
+export declare const descriptorFieldEntries: {
+    /** Stable key the value is stored/sent under (e.g. `docTypes`, `entity`). */
+    readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    /** Human label for the form field (deployment-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.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+    /** Optional input placeholder. */
+    readonly placeholder: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+    /** Whether the value is required (absent means optional). A hidden field is never required. */
+    readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Choices for a `select` / `checkbox-group` field; ignored for the other types. */
+    readonly options: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** The value stored when this choice is picked (an enum-stable string). */
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        /** The caption shown in the form, and rendered in place of the value in prose. */
+        readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    }, undefined>, undefined>, undefined>;
+    /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`), used to seed the form. */
+    readonly default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    /** The multi-select default for a `checkbox-group` field. */
+    readonly defaultValues: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, undefined>;
+    /** Single-condition visibility; absent means 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>;
+    /**
+     * Max length for a string value (characters), enforced by the input AND the validator.
+     *
+     * Capped at {@link DESCRIPTOR_FIELD_VALUE_MAX}, the bound the filled bag itself carries: a
+     * descriptor allowed to declare more would render an input that accepts what the wire schema
+     * then refuses, and that refusal arrives as a raw schema error from the request parse rather
+     * than the readable per-field message {@link validateDescriptorFields} produces.
+     */
+    readonly maxLength: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2000, undefined>]>, undefined>;
+};
+/**
+ * A descriptor field admitting EVERY type: the shape the shared helpers below take. A surface's
+ * own narrower field type is structurally assignable to it, so `validate`/`sanitize`/`render`
+ * work against a preset's fields and a task type's alike with no adapter.
+ */
+export declare const descriptorFieldSchema: v.ObjectSchema<{
+    /** Stable key the value is stored/sent under (e.g. `docTypes`, `entity`). */
+    readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    /** Human label for the form field (deployment-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.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+    /** Optional input placeholder. */
+    readonly placeholder: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+    /** Whether the value is required (absent means optional). A hidden field is never required. */
+    readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Choices for a `select` / `checkbox-group` field; ignored for the other types. */
+    readonly options: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** The value stored when this choice is picked (an enum-stable string). */
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        /** The caption shown in the form, and rendered in place of the value in prose. */
+        readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    }, undefined>, undefined>, undefined>;
+    /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`), used to seed the form. */
+    readonly default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    /** The multi-select default for a `checkbox-group` field. */
+    readonly defaultValues: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, undefined>;
+    /** Single-condition visibility; absent means 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>;
+    /**
+     * Max length for a string value (characters), enforced by the input AND the validator.
+     *
+     * Capped at {@link DESCRIPTOR_FIELD_VALUE_MAX}, the bound the filled bag itself carries: a
+     * descriptor allowed to declare more would render an input that accepts what the wire schema
+     * then refuses, and that refusal arrives as a raw schema error from the request parse rather
+     * than the readable per-field message {@link validateDescriptorFields} produces.
+     */
+    readonly maxLength: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2000, 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>;
+}, undefined>;
+export type DescriptorField = v.InferOutput<typeof descriptorFieldSchema>;
+/**
+ * Whether `path` is a SAFE repo-relative DIRECTORY (the `path`-field analogue of `isSafeDocPath`,
+ * minus the `.md` requirement). A `path` value is used verbatim as an in-repo placement dir that
+ * agents 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 values (its `showWhen` condition). */
+export declare function isDescriptorFieldVisible(field: DescriptorField, values: DescriptorFieldValues): boolean;
+/**
+ * Validate filled values against a field list, returning a list of human-readable problems (EMPTY
+ * means valid). Pure + total (never throws), so a controller maps a non-empty result to a single
+ * `ValidationError` and the SPA disables its submit button off the same call. Enforces: no unknown
+ * keys, the right value type per field, required VISIBLE fields present,
+ * `select`/`checkbox-group` values drawn from the declared options, declared `maxLength` respected,
+ * 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 validateDescriptorFields(fields: readonly DescriptorField[], values: DescriptorFieldValues): string[];
+/**
+ * Reduce filled values to the ones SAFE to freeze: only fields the list declares, that are
+ * currently VISIBLE (their `showWhen` holds), and that {@link validateDescriptorFields} actually
+ * inspected. Unknown keys and hidden fields, whose stale values validation deliberately skips, are
+ * dropped, so a hidden field can never freeze an unvalidated value (e.g. a `path` that escapes the
+ * repo). Pure + total; run AFTER validation, on values already known valid.
+ *
+ * The UNFILLED values go too, and that is the same rule rather than a second one: validation
+ * short-circuits on a value that says nothing, so a `false` on a `text` field, a blank string or
+ * an empty multi-select reaches here having passed NO type check. Keeping them would freeze a
+ * wrong-typed answer the prompt fold then renders to every agent as the operation's own brief
+ * (`notes: false` reads as `Notes: No`), and would put a `custom` bag on a row that collected
+ * nothing, when its presence is what tells the dispatch projection parameters WERE collected. The
+ * one exception is {@link isExplicitOptOut}.
+ */
+export declare function sanitizeDescriptorFields(fields: readonly DescriptorField[], values: DescriptorFieldValues): DescriptorFieldValues;
+/**
+ * Render one filled value as human-readable prose (option captions preferred over raw values,
+ * `checkbox-group` joined, boolean as `Yes`/`No`). Shared by the initiative create flow's
+ * skip-interview qa seeding, the operation prompt fold, and the SPA form review, so a field reads
+ * identically everywhere. Deployment-supplied English. Pure + total.
+ *
+ * `field` is OPTIONAL because a bag key can outlive the descriptor that declared it (a node whose
+ * build predates a re-registration still has to render the row it stored). With no field there is
+ * no option list to consult, so the raw value is the answer; the caller does not have to invent a
+ * fieldless descriptor to say so.
+ */
+export declare function renderDescriptorFieldValue(field: DescriptorField | undefined, value: DescriptorFieldValue): string;
+//# sourceMappingURL=form-fields.d.ts.map

package/dist/form-fields.d.ts.map

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

package/dist/form-fields.js

@@ -0,0 +1,315 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// ONE descriptor-driven form vocabulary, shared by every surface where a DEPLOYMENT declares a
+// small form and the platform collects, validates, freezes and renders the answers as data:
+//
+//   - an initiative PRESET's create form (`initiative-preset.ts`, values on `presetInputs`)
+//   - a reusable OPERATION's per-case brief (a custom task type's `fields` in `task-types.ts`,
+//     values in the sparse `taskTypeFields.custom` bag)
+//
+// The two grew the same shape independently, and the second was the poorer copy: four input types
+// against eight, no defaults, no conditional visibility, and no shared validation, so a form that
+// rendered correctly in one surface was unexpressible in the other. This module is the union, and
+// each surface declares only WHICH TYPES it admits over it (see `taskTypeFieldTypeSchema`, which
+// excludes `password` by construction: a task field value reaches prompts, the board snapshot and
+// telemetry, so a secret belongs in the capability-credential store instead).
+//
+// Everything here is PURE and total, because the same rule has to hold at four doors: the SPA's
+// submit button, the internal create controller, the public API, and (for rendering) the prompt
+// fold. Descriptor labels/help/option captions are DEPLOYMENT-authored English rendered verbatim
+// (the `describeConfig` convention); only the chrome around them is i18n.
+// ---------------------------------------------------------------------------
+/** Bound on a field `key`, and on a key in a filled {@link descriptorFieldValuesSchema} bag. */
+export const DESCRIPTOR_FIELD_KEY_MAX = 80;
+/** Bound on a single string / string-array element value. */
+export const DESCRIPTOR_FIELD_VALUE_MAX = 2000;
+/** Bound on the number of elements in a `checkbox-group` (multi-value) answer. */
+export const DESCRIPTOR_FIELD_ARRAY_MAX = 50;
+/** One filled value: a scalar (`text`/`select`/`path`/…), a multi-select, a toggle, or a number. */
+export const descriptorFieldValueSchema = v.union([
+    v.pipe(v.string(), v.maxLength(DESCRIPTOR_FIELD_VALUE_MAX)),
+    v.pipe(v.array(v.pipe(v.string(), v.maxLength(DESCRIPTOR_FIELD_VALUE_MAX))), v.maxLength(DESCRIPTOR_FIELD_ARRAY_MAX)),
+    v.boolean(),
+    v.number(),
+]);
+/** A filled descriptor form: a bounded map from field `key` to its value. */
+export const descriptorFieldValuesSchema = v.record(v.pipe(v.string(), v.minLength(1), v.maxLength(DESCRIPTOR_FIELD_KEY_MAX)), descriptorFieldValueSchema);
+/**
+ * How a field is rendered and collected. The first six mirror `ProviderConfigField`'s types
+ * exactly; `checkbox-group` (a multi-select, value `string[]`) and `path` (a repo-relative
+ * directory, {@link isSafeRepoDirPath}-validated) are the two the preset form added.
+ *
+ * A surface may admit a SUBSET (each declares its own picklist over these members) but never a
+ * member outside them: the renderer and the validators below switch over exactly this union.
+ */
+export const descriptorFieldTypeSchema = 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 ("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 descriptorFieldShowWhenSchema = 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 choice of a `select` / `checkbox-group` field. */
+export const descriptorFieldOptionSchema = v.object({
+    /** The value stored when this choice is picked (an enum-stable string). */
+    value: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** The caption shown in the form, and rendered in place of the value in prose. */
+    label: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+});
+/**
+ * Everything a descriptor field carries EXCEPT its `type`, which each surface narrows to its own
+ * admitted picklist. Spread into that surface's own `v.object({ ...descriptorFieldEntries, type })`
+ * so the shared bounds cannot drift per surface and a new shared attribute reaches both at once.
+ */
+export const descriptorFieldEntries = {
+    /** Stable key the value is stored/sent under (e.g. `docTypes`, `entity`). */
+    key: v.pipe(v.string(), v.minLength(1), v.maxLength(DESCRIPTOR_FIELD_KEY_MAX)),
+    /** Human label for the form field (deployment-supplied English). */
+    label: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** Optional helper text shown under the field. */
+    help: v.optional(v.pipe(v.string(), v.maxLength(300))),
+    /** Optional input placeholder. */
+    placeholder: v.optional(v.pipe(v.string(), v.maxLength(200))),
+    /** Whether the value is required (absent means optional). A hidden field is never required. */
+    required: v.optional(v.boolean()),
+    /** Choices for a `select` / `checkbox-group` field; ignored for the other types. */
+    options: v.optional(v.array(descriptorFieldOptionSchema)),
+    /** The scalar default (`text`/`select`/`path`/`number`/`checkbox`), used to seed the form. */
+    default: v.optional(v.pipe(v.string(), v.maxLength(DESCRIPTOR_FIELD_VALUE_MAX))),
+    /** The multi-select default for a `checkbox-group` field. */
+    defaultValues: v.optional(v.pipe(v.array(v.pipe(v.string(), v.maxLength(DESCRIPTOR_FIELD_VALUE_MAX))), v.maxLength(DESCRIPTOR_FIELD_ARRAY_MAX))),
+    /** Single-condition visibility; absent means always shown. */
+    showWhen: v.optional(descriptorFieldShowWhenSchema),
+    /**
+     * Max length for a string value (characters), enforced by the input AND the validator.
+     *
+     * Capped at {@link DESCRIPTOR_FIELD_VALUE_MAX}, the bound the filled bag itself carries: a
+     * descriptor allowed to declare more would render an input that accepts what the wire schema
+     * then refuses, and that refusal arrives as a raw schema error from the request parse rather
+     * than the readable per-field message {@link validateDescriptorFields} produces.
+     */
+    maxLength: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(DESCRIPTOR_FIELD_VALUE_MAX))),
+};
+/**
+ * A descriptor field admitting EVERY type: the shape the shared helpers below take. A surface's
+ * own narrower field type is structurally assignable to it, so `validate`/`sanitize`/`render`
+ * work against a preset's fields and a task type's alike with no adapter.
+ */
+export const descriptorFieldSchema = v.object({
+    ...descriptorFieldEntries,
+    /** Field type; absent is treated as `text`. */
+    type: v.optional(descriptorFieldTypeSchema),
+});
+// ---------------------------------------------------------------------------
+// Path safety, visibility, validation, sanitization, rendering: the pure rules every door shares.
+// ---------------------------------------------------------------------------
+/**
+ * Whether `path` is a SAFE repo-relative DIRECTORY (the `path`-field analogue of `isSafeDocPath`,
+ * minus the `.md` requirement). A `path` value is used verbatim as an in-repo placement dir that
+ * agents 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 values (its `showWhen` condition). */
+export function isDescriptorFieldVisible(field, values) {
+    const cond = field.showWhen;
+    if (!cond)
+        return true;
+    const value = values[cond.key];
+    if (cond.equals !== undefined) {
+        // An unchecked checkbox is ABSENT from the values (an off box stays unset: see the form
+        // renderer's drop-when-empty rule), so an absent value reads as `false` when the condition
+        // compares against a boolean. Without this, `equals: false` would never match at initial
+        // render (only after a toggle on then off), hiding a field that should be shown.
+        const actual = value === undefined && typeof cond.equals === 'boolean' ? false : value;
+        return actual === 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';
+    }
+}
+/**
+ * Whether a value counts as FILLED. A checkbox is "present" only when checked, so a required
+ * checkbox means "must be checked" and an unchecked `false` counts as unset. A numeric `0` is a
+ * real answer (the strict comparisons never match it).
+ */
+function isFilled(value) {
+    if (value === undefined || value === false)
+        return false;
+    if (typeof value === 'string')
+        return value.trim() !== '';
+    if (Array.isArray(value))
+        return value.length > 0;
+    return true;
+}
+/**
+ * Whether a value {@link isFilled} rejects is nonetheless an ANSWER worth freezing. Exactly one
+ * is: an explicit `false` on a `checkbox`, which is the opt-OUT of a default-ON toggle. Absent and
+ * `false` are the same value there and opposite facts, so dropping it would leave a consumer
+ * reading `inputs[key] !== false` (the tech-migration preset's `humanReview`) unable to ever
+ * observe the unchecked state, and the toggle would be dead.
+ *
+ * A `false` on any OTHER field type is not an answer at all: it is a wrong-typed value that
+ * {@link validateDescriptorFields} never type-checked, because the fill check short-circuits
+ * first. Same for a blank string or an empty multi-select, which say nothing anywhere.
+ */
+function isExplicitOptOut(field, value) {
+    return field.type === 'checkbox' && value === false;
+}
+/**
+ * Validate filled values against a field list, returning a list of human-readable problems (EMPTY
+ * means valid). Pure + total (never throws), so a controller maps a non-empty result to a single
+ * `ValidationError` and the SPA disables its submit button off the same call. Enforces: no unknown
+ * keys, the right value type per field, required VISIBLE fields present,
+ * `select`/`checkbox-group` values drawn from the declared options, declared `maxLength` respected,
+ * 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 validateDescriptorFields(fields, values) {
+    const problems = [];
+    const byKey = new Map(fields.map((f) => [f.key, f]));
+    for (const key of Object.keys(values)) {
+        if (!byKey.has(key))
+            problems.push(`Unknown field "${key}".`);
+    }
+    for (const field of fields) {
+        if (!isDescriptorFieldVisible(field, values))
+            continue;
+        const value = values[field.key];
+        if (!isFilled(value)) {
+            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;
+        }
+        problems.push(...semanticProblems(field, value));
+    }
+    return problems;
+}
+/** The per-type semantic checks, once the value is present and structurally right. */
+function semanticProblems(field, value) {
+    const problems = [];
+    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).`);
+    }
+    // A declared `maxLength` binds the SERVER too, not only the input's own attribute: a form is not
+    // the only door (the public API fills the same fields), so the descriptor's stated bound has to
+    // hold where the value is actually frozen.
+    if (field.maxLength !== undefined &&
+        typeof value === 'string' &&
+        value.length > field.maxLength) {
+        problems.push(`Field "${field.key}" exceeds its maximum length of ${field.maxLength}.`);
+    }
+    return problems;
+}
+/**
+ * Reduce filled values to the ones SAFE to freeze: only fields the list declares, that are
+ * currently VISIBLE (their `showWhen` holds), and that {@link validateDescriptorFields} actually
+ * inspected. Unknown keys and hidden fields, whose stale values validation deliberately skips, are
+ * dropped, so a hidden field can never freeze an unvalidated value (e.g. a `path` that escapes the
+ * repo). Pure + total; run AFTER validation, on values already known valid.
+ *
+ * The UNFILLED values go too, and that is the same rule rather than a second one: validation
+ * short-circuits on a value that says nothing, so a `false` on a `text` field, a blank string or
+ * an empty multi-select reaches here having passed NO type check. Keeping them would freeze a
+ * wrong-typed answer the prompt fold then renders to every agent as the operation's own brief
+ * (`notes: false` reads as `Notes: No`), and would put a `custom` bag on a row that collected
+ * nothing, when its presence is what tells the dispatch projection parameters WERE collected. The
+ * one exception is {@link isExplicitOptOut}.
+ */
+export function sanitizeDescriptorFields(fields, values) {
+    const sanitized = {};
+    for (const field of fields) {
+        if (!isDescriptorFieldVisible(field, values))
+            continue;
+        const value = values[field.key];
+        if (value === undefined)
+            continue;
+        if (!isFilled(value) && !isExplicitOptOut(field, value))
+            continue;
+        sanitized[field.key] = value;
+    }
+    return sanitized;
+}
+/**
+ * Render one filled value as human-readable prose (option captions preferred over raw values,
+ * `checkbox-group` joined, boolean as `Yes`/`No`). Shared by the initiative create flow's
+ * skip-interview qa seeding, the operation prompt fold, and the SPA form review, so a field reads
+ * identically everywhere. Deployment-supplied English. Pure + total.
+ *
+ * `field` is OPTIONAL because a bag key can outlive the descriptor that declared it (a node whose
+ * build predates a re-registration still has to render the row it stored). With no field there is
+ * no option list to consult, so the raw value is the answer; the caller does not have to invent a
+ * fieldless descriptor to say so.
+ */
+export function renderDescriptorFieldValue(field, value) {
+    const labelOf = (raw) => (field?.options ?? []).find((o) => o.value === raw)?.label ?? raw;
+    if (Array.isArray(value))
+        return value.map(labelOf).join(', ');
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    if (typeof value === 'number')
+        return String(value);
+    return labelOf(value);
+}
+//# sourceMappingURL=form-fields.js.map

package/dist/form-fields.js.map

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

package/dist/index.d.ts

@@ -77,6 +77,7 @@ export * from './package-registries.js';
 export * from './agent-config.js';
 export * from './result-views.js';
 export * from './agent-presentation.js';
+export * from './form-fields.js';
 export * from './task-types.js';
 export * from './testing.js';
 export * from './compute-provisioning.js';