@cat-factory/contracts 0.99.0 → 0.101.0

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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"}

package/dist/initiative.d.ts

@@ -4,6 +4,16 @@ export declare const INITIATIVE_TITLE_MAX = 200;
 export declare const INITIATIVE_PROSE_MAX = 8000;
 export declare const INITIATIVE_SHORT_MAX = 2000;
 export declare const INITIATIVE_MAX_CONCURRENT = 20;
+/** Bound on a single string / string-array element value in {@link initiativePresetInputsSchema}. */
+export declare const INITIATIVE_PRESET_INPUT_MAX = 2000;
+/** Bound on the number of elements in a `checkbox-group`/multi-value input. */
+export declare const INITIATIVE_PRESET_INPUT_ARRAY_MAX = 50;
+/** One filled preset-form value: a scalar (`text`/`select`/`path`/…), a multi-select, a toggle, or a number. */
+export declare const initiativePresetInputValueSchema: 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 InitiativePresetInputValue = v.InferOutput<typeof initiativePresetInputValueSchema>;
+/** The user's filled preset form — a bounded map from field `key` to its value. */
+export declare const initiativePresetInputsSchema: 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 InitiativePresetInputs = v.InferOutput<typeof initiativePresetInputsSchema>;
 /** Lifecycle of a single tracker item (one unit of work → one spawned task). */
 export declare const initiativeItemStatusSchema: v.PicklistSchema<["pending", "in_progress", "pr_open", "done", "blocked", "skipped"], undefined>;
 export type InitiativeItemStatus = v.InferOutput<typeof initiativeItemStatusSchema>;
@@ -70,6 +80,43 @@ export declare const initiativePhaseSchema: v.ObjectSchema<{
     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>;
 }, undefined>;
 export type InitiativePhase = v.InferOutput<typeof initiativePhaseSchema>;
+/**
+ * Preset-authored decoration for a spawned task, folded onto the task block by the
+ * execution loop's `buildTaskBlock` (slice 5) so an item comes out as a first-class typed
+ * task rather than a bare description block. Every field is optional and additive:
+ *   - `taskTypeFields` — the per-type block fields (a doc task's `targetPath`/`docKind`, …).
+ *   - `fragmentIds`    — best-practice prompt fragments to stamp on the block.
+ *   - `agentConfig`    — per-agent-kind config values for the spawned pipeline.
+ *   - `gates`          — a per-run gate override (parallel to the pipeline's steps, one
+ *                        boolean each), threaded through the slice-2 gate-override seam.
+ * Emitted by the planner (via the draft item) and/or enforced by a preset's `seedPlan`.
+ */
+export declare const initiativeItemSpawnSchema: v.ObjectSchema<{
+    readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+        readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+        readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+        readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+        readonly docKind: v.OptionalSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+        readonly audience: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+        readonly targetPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>, v.CheckAction<string, "targetPath must be a relative path inside the repo, ending in .md, with no \"..\", absolute, or backslash segments.">]>, undefined>;
+        readonly outlineHints: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+        readonly targetUsers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly successMetrics: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly alternativesConsidered: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly rolloutConcerns: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly decisionDrivers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly consideredOptions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly whenToUse: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly escalationPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly researchQuestion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly optionsToCompare: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly apiSurface: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    }, undefined>, undefined>;
+    readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+    readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type InitiativeItemSpawn = v.InferOutput<typeof initiativeItemSpawnSchema>;
 /** One unit of work in the tracker — spawned just-in-time as a task block. */
 export declare const initiativeItemSchema: v.ObjectSchema<{
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
@@ -99,6 +146,32 @@ export declare const initiativeItemSchema: v.ObjectSchema<{
     }, undefined>, undefined>;
     /** Loop/human annotation — e.g. the failure detail that blocked the item. */
     readonly note: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    /** Preset-authored spawn decoration stamped onto the spawned task block (slice 5). */
+    readonly spawn: v.OptionalSchema<v.ObjectSchema<{
+        readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+            readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+            readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+            readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+            readonly docKind: v.OptionalSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+            readonly audience: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+            readonly targetPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>, v.CheckAction<string, "targetPath must be a relative path inside the repo, ending in .md, with no \"..\", absolute, or backslash segments.">]>, undefined>;
+            readonly outlineHints: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+            readonly targetUsers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly successMetrics: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly alternativesConsidered: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly rolloutConcerns: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly decisionDrivers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly consideredOptions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly whenToUse: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly escalationPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly researchQuestion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly optionsToCompare: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly apiSurface: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        }, undefined>, undefined>;
+        readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+        readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
 }, undefined>;
 export type InitiativeItem = v.InferOutput<typeof initiativeItemSchema>;
 /** A decision recorded on the tracker (made during planning or mid-flight). */
@@ -173,6 +246,16 @@ export declare const initiativeSchema: v.ObjectSchema<{
     /** Stable slug naming the in-repo tracker folder (`docs/initiatives/<slug>/`). */
     readonly slug: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+    /**
+     * The initiative-preset this initiative was created from (see `initiative-preset.ts`).
+     * Absent ⇒ a preset-less initiative created by an old client / the public API — its
+     * behaviour is byte-for-byte today's (the generic pipeline, human review on). The SPA
+     * picker seeds `preset_generic` for new initiatives, but a preset only ever ADDS context;
+     * nothing in the planning/loop path branches on its presence.
+     */
+    readonly presetId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, undefined>;
+    /** The user's filled preset form, FROZEN at create (the `agentConfig` freeze precedent). */
+    readonly presetInputs: 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>;
     /** The agreed goal statement (from planning). */
     readonly goal: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 8000, undefined>]>, "">;
     readonly constraints: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, readonly []>;
@@ -227,6 +310,32 @@ export declare const initiativeSchema: v.ObjectSchema<{
         }, undefined>, undefined>;
         /** Loop/human annotation — e.g. the failure detail that blocked the item. */
         readonly note: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        /** Preset-authored spawn decoration stamped onto the spawned task block (slice 5). */
+        readonly spawn: v.OptionalSchema<v.ObjectSchema<{
+            readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+                readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+                readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+                readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+                readonly docKind: v.OptionalSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+                readonly audience: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+                readonly targetPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>, v.CheckAction<string, "targetPath must be a relative path inside the repo, ending in .md, with no \"..\", absolute, or backslash segments.">]>, undefined>;
+                readonly outlineHints: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+                readonly targetUsers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly successMetrics: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly alternativesConsidered: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly rolloutConcerns: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly decisionDrivers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly consideredOptions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly whenToUse: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly escalationPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly researchQuestion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly optionsToCompare: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly apiSurface: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            }, undefined>, undefined>;
+            readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+            readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>, readonly []>;
     readonly policy: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
         /** Max concurrently-running spawned tasks across the whole initiative. */
@@ -306,6 +415,32 @@ export declare const initiativeDraftItemSchema: v.ObjectSchema<{
         readonly rationale: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
     }, undefined>, undefined>;
     readonly pipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, undefined>;
+    /** Preset-authored spawn decoration (a `seedPlan` may enforce/override it at ingest). */
+    readonly spawn: v.OptionalSchema<v.ObjectSchema<{
+        readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+            readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+            readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+            readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+            readonly docKind: v.OptionalSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+            readonly audience: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+            readonly targetPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>, v.CheckAction<string, "targetPath must be a relative path inside the repo, ending in .md, with no \"..\", absolute, or backslash segments.">]>, undefined>;
+            readonly outlineHints: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+            readonly targetUsers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly successMetrics: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly alternativesConsidered: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly rolloutConcerns: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly decisionDrivers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly consideredOptions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly whenToUse: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly escalationPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly researchQuestion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly optionsToCompare: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            readonly apiSurface: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        }, undefined>, undefined>;
+        readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+        readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
 }, undefined>;
 export type InitiativeDraftItem = v.InferOutput<typeof initiativeDraftItemSchema>;
 /**
@@ -338,6 +473,32 @@ export declare const initiativePlanDraftSchema: v.ObjectSchema<{
             readonly rationale: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
         }, undefined>, undefined>;
         readonly pipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, undefined>;
+        /** Preset-authored spawn decoration (a `seedPlan` may enforce/override it at ingest). */
+        readonly spawn: v.OptionalSchema<v.ObjectSchema<{
+            readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+                readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+                readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+                readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+                readonly docKind: v.OptionalSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+                readonly audience: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+                readonly targetPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>, v.CheckAction<string, "targetPath must be a relative path inside the repo, ending in .md, with no \"..\", absolute, or backslash segments.">]>, undefined>;
+                readonly outlineHints: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+                readonly targetUsers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly successMetrics: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly alternativesConsidered: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly rolloutConcerns: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly decisionDrivers: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly consideredOptions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly whenToUse: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly escalationPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly researchQuestion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly optionsToCompare: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+                readonly apiSurface: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+            }, undefined>, undefined>;
+            readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+            readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>;
     readonly policy: v.ObjectSchema<{
         /** Max concurrently-running spawned tasks across the whole initiative. */

package/dist/initiative.d.ts.map

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

package/dist/initiative.js

@@ -1,4 +1,6 @@
 import * as v from 'valibot';
+import { taskTypeFieldsSchema } from './primitives.js';
+import { agentConfigValuesSchema } from './agent-config.js';
 // ---------------------------------------------------------------------------
 // Initiative wire contracts. An Initiative is the longer-running counterpart to
 // a task: a multi-phase body of work (a cross-cutting refactor, a migration, a
@@ -30,6 +32,27 @@ const idField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(INITIAT
 const titleField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(INITIATIVE_TITLE_MAX));
 const proseField = v.pipe(v.string(), v.maxLength(INITIATIVE_PROSE_MAX));
 const shortProseField = v.pipe(v.string(), v.maxLength(INITIATIVE_SHORT_MAX));
+// ---------------------------------------------------------------------------
+// Initiative-preset inputs. A preset (see `initiative-preset.ts`) bundles a
+// backend-supplied FORM the user fills at create time; the filled values are this
+// bounded JSON record, persisted on the entity (`presetInputs`) and FROZEN after
+// create. Kept HERE (with the entity that persists them, next to the item `spawn`
+// bag) rather than in `initiative-preset.ts` so the entity can reference the shape
+// without a module cycle — the preset descriptor imports these back the other way.
+// ---------------------------------------------------------------------------
+/** Bound on a single string / string-array element value in {@link initiativePresetInputsSchema}. */
+export const INITIATIVE_PRESET_INPUT_MAX = 2000;
+/** Bound on the number of elements in a `checkbox-group`/multi-value input. */
+export const INITIATIVE_PRESET_INPUT_ARRAY_MAX = 50;
+/** One filled preset-form value: a scalar (`text`/`select`/`path`/…), a multi-select, a toggle, or a number. */
+export const initiativePresetInputValueSchema = v.union([
+    v.pipe(v.string(), v.maxLength(INITIATIVE_PRESET_INPUT_MAX)),
+    v.pipe(v.array(v.pipe(v.string(), v.maxLength(INITIATIVE_PRESET_INPUT_MAX))), v.maxLength(INITIATIVE_PRESET_INPUT_ARRAY_MAX)),
+    v.boolean(),
+    v.number(),
+]);
+/** The user's filled preset form — a bounded map from field `key` to its value. */
+export const initiativePresetInputsSchema = v.record(v.pipe(v.string(), v.minLength(1), v.maxLength(INITIATIVE_ID_MAX)), initiativePresetInputValueSchema);
 /** Lifecycle of a single tracker item (one unit of work → one spawned task). */
 export const initiativeItemStatusSchema = v.picklist([
     'pending',
@@ -99,6 +122,23 @@ export const initiativePhaseSchema = v.object({
     /** Optional tighter concurrency cap for this phase alone. */
     maxConcurrent: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(INITIATIVE_MAX_CONCURRENT))),
 });
+/**
+ * Preset-authored decoration for a spawned task, folded onto the task block by the
+ * execution loop's `buildTaskBlock` (slice 5) so an item comes out as a first-class typed
+ * task rather than a bare description block. Every field is optional and additive:
+ *   - `taskTypeFields` — the per-type block fields (a doc task's `targetPath`/`docKind`, …).
+ *   - `fragmentIds`    — best-practice prompt fragments to stamp on the block.
+ *   - `agentConfig`    — per-agent-kind config values for the spawned pipeline.
+ *   - `gates`          — a per-run gate override (parallel to the pipeline's steps, one
+ *                        boolean each), threaded through the slice-2 gate-override seam.
+ * Emitted by the planner (via the draft item) and/or enforced by a preset's `seedPlan`.
+ */
+export const initiativeItemSpawnSchema = v.object({
+    taskTypeFields: v.optional(taskTypeFieldsSchema),
+    fragmentIds: v.optional(v.array(v.string())),
+    agentConfig: v.optional(agentConfigValuesSchema),
+    gates: v.optional(v.array(v.boolean())),
+});
 /** One unit of work in the tracker — spawned just-in-time as a task block. */
 export const initiativeItemSchema = v.object({
     id: idField,
@@ -120,6 +160,8 @@ export const initiativeItemSchema = v.object({
     pr: v.optional(v.object({ url: v.string(), number: v.optional(v.number()) })),
     /** Loop/human annotation — e.g. the failure detail that blocked the item. */
     note: v.optional(shortProseField),
+    /** Preset-authored spawn decoration stamped onto the spawned task block (slice 5). */
+    spawn: v.optional(initiativeItemSpawnSchema),
 });
 /** A decision recorded on the tracker (made during planning or mid-flight). */
 export const initiativeDecisionSchema = v.object({
@@ -188,6 +230,16 @@ export const initiativeSchema = v.object({
     /** Stable slug naming the in-repo tracker folder (`docs/initiatives/<slug>/`). */
     slug: idField,
     title: titleField,
+    /**
+     * The initiative-preset this initiative was created from (see `initiative-preset.ts`).
+     * Absent ⇒ a preset-less initiative created by an old client / the public API — its
+     * behaviour is byte-for-byte today's (the generic pipeline, human review on). The SPA
+     * picker seeds `preset_generic` for new initiatives, but a preset only ever ADDS context;
+     * nothing in the planning/loop path branches on its presence.
+     */
+    presetId: v.optional(idField),
+    /** The user's filled preset form, FROZEN at create (the `agentConfig` freeze precedent). */
+    presetInputs: v.optional(initiativePresetInputsSchema),
     /** The agreed goal statement (from planning). */
     goal: v.optional(proseField, ''),
     constraints: v.optional(v.array(shortProseField), []),
@@ -228,6 +280,8 @@ export const initiativeDraftItemSchema = v.object({
     dependsOn: v.optional(v.array(idField), []),
     estimate: v.optional(initiativeEstimateSchema),
     pipelineId: v.optional(idField),
+    /** Preset-authored spawn decoration (a `seedPlan` may enforce/override it at ingest). */
+    spawn: v.optional(initiativeItemSpawnSchema),
 });
 /**
  * The `initiative-planner` agent's structured output: the multi-phase plan minus