@cat-factory/contracts 0.229.0 → 0.231.0

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":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,+FAA+F;AAC/F,4FAA4F;AAC5F,EAAE;AACF,4FAA4F;AAC5F,+FAA+F;AAC/F,wDAAwD;AACxD,EAAE;AACF,kGAAkG;AAClG,kGAAkG;AAClG,kGAAkG;AAClG,iGAAiG;AACjG,kGAAkG;AAClG,8EAA8E;AAC9E,EAAE;AACF,gGAAgG;AAChG,gGAAgG;AAChG,iGAAiG;AACjG,0EAA0E;AAC1E,8EAA8E;AAE9E,gGAAgG;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAA;AAC1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAA;AAC9C,kFAAkF;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAE5C,oGAAoG;AACpG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC3D,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,EACpE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CACxC;IACD,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAA;AAGF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,EACzE,0BAA0B,CAC3B,CAAA;AAGD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAClD,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;IACV,gBAAgB;IAChB,MAAM;CACP,CAAC,CAAA;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,sEAAsE;IACtE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvC;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClE,qEAAqE;IACrE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC,CAAA;AAGF,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,2EAA2E;IAC3E,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3D,kFAAkF;IAClF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAC5D,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,6EAA6E;IAC7E,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC9E,oEAAoE;IACpE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3D,kDAAkD;IAClD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,kCAAkC;IAClC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,+FAA+F;IAC/F,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,oFAAoF;IACpF,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzD,8FAA8F;IAC9F,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAChF,6DAA6D;IAC7D,aAAa,EAAE,CAAC,CAAC,QAAQ,CACvB,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAAC,EACpE,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CACxC,CACF;IACD,8DAA8D;IAC9D,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnD;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,CAAC,QAAQ,CACnB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CACvF;CACO,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,sBAAsB;IACzB,+CAA+C;IAC/C,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC5C,CAAC,CAAA;AAGF,8EAA8E;AAC9E,kGAAkG;AAClG,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IACrB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3D,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACtD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CACtC,KAAsB,EACtB,MAA6B;IAE7B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,wFAAwF;QACxF,2FAA2F;QAC3F,yFAAyF;QACzF,iFAAiF;QACjF,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QACtF,OAAO,MAAM,KAAK,IAAI,CAAC,MAAM,CAAA;IAC/B,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7F,yFAAyF;IACzF,OAAO,IAAI,CAAA;AACb,CAAC;AAED,iGAAiG;AACjG,SAAS,qBAAqB,CAAC,KAAsB,EAAE,KAA2B;IAChF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,gBAAgB;YACnB,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC7B,KAAK,UAAU;YACb,OAAO,OAAO,KAAK,KAAK,SAAS,CAAA;QACnC,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;QAClC;YACE,oFAAoF;YACpF,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;IACpC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAuC;IACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IACjD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,KAAsB,EAAE,KAA2B;IAC3E,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,CAAA;AACrD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAkC,EAClC,MAA6B;IAE7B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAEpD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,SAAQ;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,IAAI,KAAK,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAA;YACtE,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,8BAA8B,KAAK,CAAC,IAAI,IAAI,MAAM,SAAS,CAAC,CAAA;YAC7F,SAAQ;QACV,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,sFAAsF;AACtF,SAAS,gBAAgB,CAAC,KAAsB,EAAE,KAA2B;IAC3E,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACvE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAe,CAAC,EAAE,CAAC;QAC3F,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,oCAAoC,CAAC,CAAA;IACxE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,KAAiB,EAAE,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,oBAAoB,KAAK,wBAAwB,CAAC,CAAA;QACvF,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAe,CAAC,EAAE,CAAC;QACjE,QAAQ,CAAC,IAAI,CACX,UAAU,KAAK,CAAC,GAAG,uFAAuF,CAC3G,CAAA;IACH,CAAC;IACD,iGAAiG;IACjG,gGAAgG;IAChG,2CAA2C;IAC3C,IACE,KAAK,CAAC,SAAS,KAAK,SAAS;QAC7B,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,EAC9B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,GAAG,mCAAmC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IACzF,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAkC,EAClC,MAA6B;IAE7B,MAAM,SAAS,GAA0B,EAAE,CAAA;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,SAAQ;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;YAAE,SAAQ;QACjE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC9B,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAkC,EAClC,KAA2B;IAE3B,MAAM,OAAO,GAAG,CAAC,GAAW,EAAU,EAAE,CACtC,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,GAAG,CAAA;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC"}

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';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -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';

package/dist/index.js.map

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

package/dist/initiative-preset.d.ts

@@ -1,68 +1,41 @@
 import * as v from 'valibot';
-import { type InitiativePresetInputs, type InitiativePresetInputValue } from './initiative.js';
+import { type DescriptorFieldShowWhen } from './form-fields.js';
+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.
+ * How a preset field is rendered/collected: the whole shared union, a preset being the surface
+ * that motivated it. `password` is admitted here (a preset input may carry a token the planning
+ * flow needs) and refused for a task type, whose values reach prompts and telemetry.
  */
 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).
- */
+/** Single-condition visibility for a preset field (the shared {@link descriptorFieldShowWhenSchema}). */
 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>;
+export type InitiativePresetShowWhen = DescriptorFieldShowWhen;
 /** 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 help: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+    readonly placeholder: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
     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>;
+        readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        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`); 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 default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    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>;
     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>;
+    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 InitiativePresetField = v.InferOutput<typeof initiativePresetFieldSchema>;
 /** Display metadata for a preset in the create-initiative picker. */
@@ -163,40 +136,25 @@ export declare const initiativePresetDescriptorSchema: v.ObjectSchema<{
     }, 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 help: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+        readonly placeholder: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
         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>;
+            readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+            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`); 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 default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        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>;
         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>;
+        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>, 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>]>;
@@ -338,40 +296,23 @@ export type InitiativePresetDescriptor = v.InferOutput<typeof initiativePresetDe
 /** 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.
+ * The field-list-shaped rules under their preset names: `isPresetFieldVisible` (a field's
+ * `showWhen` against the current inputs), `renderInitiativePresetValue` (one value as prose), and
+ * the `path` write-boundary guard. Aliases, not copies: one implementation, two vocabularies.
  */
-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;
+export { isDescriptorFieldVisible as isPresetFieldVisible, isSafeRepoDirPath, renderDescriptorFieldValue as renderInitiativePresetValue, } from './form-fields.js';
 /**
  * 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.
+ * problems (EMPTY means valid). Pure + total (never throws), so the create controller can map a
+ * non-empty result to a single ValidationError and the SPA can disable submit off the same call.
  */
 export declare function validateInitiativePresetInputs(descriptor: InitiativePresetDescriptor, inputs: InitiativePresetInputs): string[];
 /**
- * Reduce a filled preset form to the values SAFE to freeze on the entity: only fields the
- * descriptor declares AND that are currently VISIBLE (their `showWhen` holds). Unknown keys and
- * hidden fields — whose stale values {@link validateInitiativePresetInputs} 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 a form already known valid.
+ * Reduce a filled preset form to the values SAFE to freeze on the entity: the declared, currently
+ * VISIBLE fields only, so a hidden field can never freeze an unvalidated value (e.g. a `path` that
+ * escapes the repo). Pure + total; run AFTER validation, on a form already known valid.
  */
 export declare function sanitizeInitiativePresetInputs(descriptor: InitiativePresetDescriptor, inputs: InitiativePresetInputs): InitiativePresetInputs;
-/**
- * Render one filled preset value as human-readable prose (option labels preferred over raw
- * values, `checkbox-group` joined, boolean → `Yes`/`No`). Shared by the create flow's skip-interview
- * qa seeding and the SPA form review so a field reads identically in both. Backend-supplied English
- * (the `describeConfig` convention). Pure + total.
- */
-export declare function renderInitiativePresetValue(field: InitiativePresetField, value: InitiativePresetInputValue): 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

@@ -1 +1 @@
-{"version":3,"file":"initiative-preset.d.ts","sourceRoot":"","sources":["../src/initiative-preset.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"initiative-preset.d.ts","sourceRoot":"","sources":["../src/initiative-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAML,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAA;AAsBxB;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,yHAA4B,CAAA;AACxE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F,yGAAyG;AACzG,eAAO,MAAM,8BAA8B;;;;aAAgC,CAAA;AAC3E,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,CAAA;AAE9D,iEAAiE;AACjE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;IAEtC,+CAA+C;;aAE/C,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;AAqBnG;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;IAC9C,8EAA8E;;IAE9E,oDAAoD;;IAEpD,qFAAqF;;IAErF,gFAAgF;;IAEhF;;;;OAIG;;aAEH,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC;IAC9C,mFAAmF;;QA3BnF,8EAA8E;;QAE9E,oDAAoD;;QAEpD,qFAAqF;;QAErF,gFAAgF;;QAEhF;;;;WAIG;;;;;;;;;;;;;;;IAwBH,4FAA4F;;aAE5F,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;IAC3C,uEAAuE;;;QAxFvE,iDAAiD;;QAEjD,2CAA2C;;QAE3C,uCAAuC;;QAEvC,gDAAgD;;;IAqFhD,oFAAoF;;;;;;;;;;;;;;;;;;;QAlGpF,+CAA+C;;;IAoG/C,yFAAyF;;IAEzF,wFAAwF;;IAExF,uFAAuF;;IAEvF,yFAAyF;;IAEzF,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEnE;;;;;OAKG;;QA3CH,mFAAmF;;YA3BnF,8EAA8E;;YAE9E,oDAAoD;;YAEpD,qFAAqF;;YAErF,gFAAgF;;YAEhF;;;;eAIG;;;;;;;;;;;;;;;QAwBH,4FAA4F;;;IAoC5F;;;;;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;AAWD;;;;GAIG;AACH,OAAO,EACL,wBAAwB,IAAI,oBAAoB,EAChD,iBAAiB,EACjB,0BAA0B,IAAI,2BAA2B,GAC1D,MAAM,kBAAkB,CAAA;AAEzB;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,EAAE,CAEV;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAExB;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAElF"}