markform 0.1.1 → 0.1.2

package/dist/index.d.mts

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
-import { $ as MultiSelectFieldSchema, $t as StepResultSchema, A as FieldValue, At as SetMultiSelectPatchSchema, B as InspectIssue, Bt as SeveritySchema, C as FieldGroup, Ct as SessionTranscriptSchema, D as FieldProgress, Dt as SetCheckboxesPatch, E as FieldKindSchema, Et as SessionTurnStats, F as HarnessConfig, Ft as SetStringListPatch, G as IssueReasonSchema, Gt as SingleSelectValue, H as InspectResult, Ht as SimpleCheckboxStateSchema, I as HarnessConfigSchema, It as SetStringListPatchSchema, J as MarkformFrontmatter, Jt as SourcePosition, K as IssueScope, Kt as SingleSelectValueSchema, L as Id, Lt as SetStringPatch, M as FillMode, Mt as SetNumberPatchSchema, N as FormSchema, Nt as SetSingleSelectPatch, O as FieldProgressSchema, Ot as SetCheckboxesPatchSchema, P as FormSchemaSchema, Pt as SetSingleSelectPatchSchema, Q as MultiSelectField, Qt as StepResult, R as IdIndexEntry, Rt as SetStringPatchSchema, S as FieldBase, St as SessionTranscript, T as FieldKind, Tt as SessionTurnSchema, U as InspectResultSchema, Ut as SingleSelectField, V as InspectIssueSchema, Vt as SimpleCheckboxState, W as IssueReason, Wt as SingleSelectFieldSchema, X as MultiCheckboxState, Xt as SourceRange, Y as MarkformFrontmatterSchema, Yt as SourcePositionSchema, Z as MultiCheckboxStateSchema, Zt as SourceRangeSchema, _ as DocumentationTag, _t as ProgressSummary, a as CheckboxProgressCounts, an as StringListValueSchema, at as NumberValueSchema, b as ExplicitCheckboxValueSchema, bt as SessionFinal, c as CheckboxValueSchema, cn as StructureSummary, ct as OptionIdSchema, d as CheckboxesValue, dn as ValidationIssueSchema, dt as Patch, en as StringField, et as MultiSelectValue, f as CheckboxesValueSchema, fn as ValidatorContext, ft as PatchSchema, g as DocumentationBlockSchema, gn as ValidatorRegistry, gt as ProgressStateSchema, h as DocumentationBlock, hn as ValidatorRefSchema, ht as ProgressState, i as CheckboxModeSchema, in as StringListValue, it as NumberValue, j as FieldValueSchema, jt as SetNumberPatch, k as FieldSchema, kt as SetMultiSelectPatch, l as CheckboxesField, ln as StructureSummarySchema, lt as OptionSchema, m as ClearFieldPatchSchema, mn as ValidatorRef, mt as ProgressCountsSchema, n as ApplyResultSchema, nn as StringListField, nt as NumberField, o as CheckboxProgressCountsSchema, on as StringValue, ot as Option, p as ClearFieldPatch, pn as ValidatorFn, pt as ProgressCounts, q as IssueScopeSchema, qt as SkipInfo, r as CheckboxMode, rn as StringListFieldSchema, rt as NumberFieldSchema, s as CheckboxValue, sn as StringValueSchema, st as OptionId, t as ApplyResult, tn as StringFieldSchema, tt as MultiSelectValueSchema, u as CheckboxesFieldSchema, un as ValidationIssue, ut as ParsedForm, v as DocumentationTagSchema, vt as ProgressSummarySchema, w as FieldGroupSchema, wt as SessionTurn, x as Field, xt as SessionFinalSchema, y as ExplicitCheckboxValue, yt as QualifiedOptionRef, z as IdSchema, zt as Severity } from "./coreTypes--6etkcwb.mjs";
+import { $ as MarkformFrontmatter, $t as SingleSelectValueSchema, A as FieldProgressSchema, At as SessionTranscriptSchema, B as HarnessConfig, Bt as SetSingleSelectPatch, C as Field, Ct as ProgressStateSchema, D as FieldKind, Dt as SessionFinal, E as FieldGroupSchema, Et as QualifiedOptionRef, F as FieldValueSchema, Ft as SetCheckboxesPatchSchema, G as InspectIssue, Gt as SetStringPatchSchema, H as Id, Ht as SetStringListPatch, I as FillMode, It as SetMultiSelectPatch, J as InspectResultSchema, Jt as SimpleCheckboxState, K as InspectIssueSchema, Kt as Severity, L as FormSchema, Lt as SetMultiSelectPatchSchema, M as FieldResponseSchema, Mt as SessionTurnSchema, N as FieldSchema, Nt as SessionTurnStats, O as FieldKindSchema, Ot as SessionFinalSchema, P as FieldValue, Pt as SetCheckboxesPatch, Q as IssueScopeSchema, Qt as SingleSelectValue, R as FormSchemaSchema, Rt as SetNumberPatch, S as ExplicitCheckboxValueSchema, Sn as ValidatorRegistry, St as ProgressState, T as FieldGroup, Tt as ProgressSummarySchema, U as IdIndexEntry, Ut as SetStringListPatchSchema, V as HarnessConfigSchema, Vt as SetSingleSelectPatchSchema, W as IdSchema, Wt as SetStringPatch, X as IssueReasonSchema, Xt as SingleSelectField, Y as IssueReason, Yt as SimpleCheckboxStateSchema, Z as IssueScope, Zt as SingleSelectFieldSchema, _ as DocumentationBlock, _n as ValidationIssueSchema, _t as ParsedForm, a as CheckboxMode, an as StepResultSchema, at as MultiSelectValue, b as DocumentationTagSchema, bn as ValidatorRef, bt as ProgressCounts, c as CheckboxProgressCountsSchema, cn as StringListField, ct as Note, d as CheckboxesField, dn as StringListValueSchema, dt as NumberValue, en as SourcePosition, et as MarkformFrontmatterSchema, f as CheckboxesFieldSchema, fn as StringValue, ft as NumberValueSchema, g as ClearFieldPatchSchema, gn as ValidationIssue, gt as OptionSchema, h as ClearFieldPatch, hn as StructureSummarySchema, ht as OptionIdSchema, i as ApplyResultSchema, in as StepResult, it as MultiSelectFieldSchema, j as FieldResponse, jt as SessionTurn, k as FieldProgress, kt as SessionTranscript, l as CheckboxValue, ln as StringListFieldSchema, lt as NumberField, m as CheckboxesValueSchema, mn as StructureSummary, mt as OptionId, n as AnswerStateSchema, nn as SourceRange, nt as MultiCheckboxStateSchema, o as CheckboxModeSchema, on as StringField, ot as MultiSelectValueSchema, p as CheckboxesValue, pn as StringValueSchema, pt as Option, q as InspectResult, qt as SeveritySchema, r as ApplyResult, rn as SourceRangeSchema, rt as MultiSelectField, s as CheckboxProgressCounts, sn as StringFieldSchema, st as NodeType, t as AnswerState, tn as SourcePositionSchema, tt as MultiCheckboxState, u as CheckboxValueSchema, un as StringListValue, ut as NumberFieldSchema, v as DocumentationBlockSchema, vn as ValidatorContext, vt as Patch, w as FieldBase, wt as ProgressSummary, x as ExplicitCheckboxValue, xn as ValidatorRefSchema, xt as ProgressCountsSchema, y as DocumentationTag, yn as ValidatorFn, yt as PatchSchema, z as FrontmatterHarnessConfig, zt as SetNumberPatchSchema } from "./coreTypes-BXhhz9Iq.mjs";
+import "@markdoc/markdoc";
 import { LanguageModel } from "ai";
 
-//#region src/engine/parse.d.ts
+//#region src/engine/parseHelpers.d.ts
 
 /** Parse error with source location info */
 declare class ParseError extends Error {
@@ -11,6 +12,8 @@ declare class ParseError extends Error {
   readonly col?: number | undefined;
   constructor(message: string, line?: number | undefined, col?: number | undefined);
 }
+//#endregion
+//#region src/engine/parse.d.ts
 /**
  * Parse a Markform .form.md document.
  *
@@ -21,9 +24,10 @@ declare class ParseError extends Error {
 declare function parseForm(markdown: string): ParsedForm;
 //#endregion
 //#region src/engine/serialize.d.ts
+
 interface SerializeOptions {
-  /** Markform version to use in frontmatter. Defaults to "0.1.0". */
-  markformVersion?: string;
+  /** Markform spec version to use in frontmatter. Defaults to MF_SPEC_VERSION. */
+  specVersion?: string;
 }
 /**
  * Serialize a ParsedForm to canonical Markdoc markdown format.
@@ -46,12 +50,12 @@ declare function computeStructureSummary(schema: FormSchema): StructureSummary;
  * Compute a progress summary for a form.
  *
  * @param schema - The form schema
- * @param values - Current field values
+ * @param responsesByFieldId - Current field responses (state + optional value)
+ * @param notes - Notes attached to fields/groups/form
  * @param issues - Validation issues (from inspect)
- * @param skips - Skip state per field (from skip_field patches)
  * @returns Progress summary with field states and counts
  */
-declare function computeProgressSummary(schema: FormSchema, values: Record<Id, FieldValue>, issues: InspectIssue[], skips?: Record<Id, SkipInfo>): ProgressSummary;
+declare function computeProgressSummary(schema: FormSchema, responsesByFieldId: Record<Id, FieldResponse>, notes: Note[], issues: InspectIssue[]): ProgressSummary;
 /**
  * Compute the overall form state from progress summary.
  *
@@ -63,10 +67,11 @@ declare function computeFormState(progress: ProgressSummary): ProgressState;
  * Determine if the form is complete (ready for submission).
  *
  * A form is complete when:
- * 1. No required fields are empty
- * 2. No fields have validation errors
- * 3. No fields are in incomplete state (e.g., partial checkbox completion)
- * 4. All fields must be addressed (answered + skipped == total)
+ * 1. No aborted fields (aborted fields block completion)
+ * 2. No required fields are empty
+ * 3. No fields have validation errors
+ * 4. No fields are in incomplete state (e.g., partial checkbox completion)
+ * 5. All fields must be addressed (answered + skipped == total)
  *
  * Every field must be explicitly addressed - either filled with a value or
  * skipped with a reason. This ensures agents fully process all fields.
@@ -85,12 +90,12 @@ interface ComputedSummaries {
  * Compute all summaries for a parsed form.
  *
  * @param schema - The form schema
- * @param values - Current field values
+ * @param responsesByFieldId - Current field responses (state + optional value)
+ * @param notes - Notes attached to fields/groups/form
  * @param issues - Validation issues
- * @param skips - Skip state per field (from skip_field patches)
  * @returns All computed summaries
  */
-declare function computeAllSummaries(schema: FormSchema, values: Record<Id, FieldValue>, issues: InspectIssue[], skips?: Record<Id, SkipInfo>): ComputedSummaries;
+declare function computeAllSummaries(schema: FormSchema, responsesByFieldId: Record<Id, FieldResponse>, notes: Note[], issues: InspectIssue[]): ComputedSummaries;
 //#endregion
 //#region src/engine/validate.d.ts
 interface ValidateOptions {
@@ -216,7 +221,7 @@ declare function coerceToFieldPatch(form: ParsedForm, fieldId: string, rawValue:
 declare function coerceInputContext(form: ParsedForm, inputContext: InputContext): CoerceInputContextResult;
 //#endregion
 //#region src/harness/harness.d.ts
-type HarnessState = "init" | "step" | "wait" | "complete";
+type HarnessState = 'init' | 'step' | 'wait' | 'complete';
 /**
  * Form harness for managing agent-driven form filling.
  */
@@ -410,7 +415,7 @@ interface FillOptions {
   /** Maximum patches per turn (default: 20) */
   maxPatchesPerTurn?: number;
   /** Maximum issues to show per turn (default: 10) */
-  maxIssues?: number;
+  maxIssuesPerTurn?: number;
   /** Target roles to fill (default: ['agent']) */
   targetRoles?: string[];
   /** Fill mode: 'continue' (skip filled) or 'overwrite' (re-fill) */
@@ -444,7 +449,7 @@ type FillStatus = {
   ok: true;
 } | {
   ok: false;
-  reason: "max_turns" | "cancelled" | "error";
+  reason: 'max_turns' | 'cancelled' | 'error';
   message?: string;
 };
 /**
@@ -469,7 +474,7 @@ interface FillResult {
   remainingIssues?: {
     ref: string;
     message: string;
-    severity: "required" | "recommended";
+    severity: 'required' | 'recommended';
     priority: number;
   }[];
 }
@@ -550,6 +555,98 @@ declare function createMockAgent(completedForm: ParsedForm): MockAgent;
  */
 declare function fillForm(options: FillOptions): Promise<FillResult>;
 //#endregion
+//#region src/harness/harnessConfigResolver.d.ts
+/**
+ * Resolve harness configuration by merging options from multiple sources.
+ *
+ * Precedence (highest to lowest):
+ * 1. options parameter (API-provided)
+ * 2. form.metadata.harnessConfig (from frontmatter)
+ * 3. Default constants
+ *
+ * @param form The parsed form (may contain frontmatter harness config)
+ * @param options API-provided options to override defaults
+ * @returns Resolved harness configuration
+ */
+declare function resolveHarnessConfig(form: ParsedForm, options?: Partial<FillOptions>): HarnessConfig;
+//#endregion
+//#region src/research/researchTypes.d.ts
+/**
+ * Research execution status.
+ */
+type ResearchStatus = 'completed' | 'incomplete' | 'max_turns_reached';
+/**
+ * Result of a research fill operation.
+ */
+interface ResearchResult {
+  /** Final status of the research */
+  status: ResearchStatus;
+  /** The filled form */
+  form: ParsedForm;
+  /** Optional session transcript for debugging */
+  transcript?: SessionTranscript;
+  /** Total harness turns executed */
+  totalTurns: number;
+  /** Total input tokens used (if available) */
+  inputTokens?: number;
+  /** Total output tokens used (if available) */
+  outputTokens?: number;
+  /** Tools available to the agent */
+  availableTools?: string[];
+  /** Path to saved .form.md file */
+  formPath?: string;
+  /** Path to saved .raw.md file */
+  rawPath?: string;
+  /** Path to saved .yaml file */
+  yamlPath?: string;
+}
+//#endregion
+//#region src/research/runResearch.d.ts
+/**
+ * Options for runResearch (FillOptions without form, since form is a separate parameter).
+ */
+type ResearchOptions = Omit<FillOptions, 'form'>;
+/**
+ * Run research fill on a form.
+ *
+ * This function fills a form using an LLM with optional web search capabilities.
+ * It resolves configuration from multiple sources (options > frontmatter > defaults)
+ * and executes the harness loop until completion or max turns.
+ *
+ * @param form The parsed form to fill
+ * @param options Fill options including model specification
+ * @returns Research result with filled form and statistics
+ */
+declare function runResearch(form: ParsedForm, options: ResearchOptions): Promise<ResearchResult>;
+//#endregion
+//#region src/research/researchFormValidation.d.ts
+/**
+ * Check if a form is configured for research mode.
+ *
+ * A form is considered a research form if it has web search configuration
+ * in its frontmatter metadata, indicated by:
+ * - webSearchModel: model ID for web search capability
+ * - enableWebSearch: boolean flag to enable web search
+ *
+ * @param form The parsed form to check
+ * @returns true if the form is configured for research
+ */
+declare function isResearchForm(form: ParsedForm): boolean;
+/**
+ * Validate that a form is suitable for research fill.
+ *
+ * Research forms should:
+ * 1. Have agent-role fields to fill
+ * 2. Not be already complete
+ *
+ * @param form The parsed form to validate
+ * @returns Object with isValid and optional error message
+ */
+declare function validateResearchForm(form: ParsedForm): {
+  isValid: boolean;
+  error?: string;
+};
+//#endregion
 //#region src/index.d.ts
 /**
  * Markform - Agent-friendly, human-readable, editable forms.
@@ -560,4 +657,4 @@ declare function fillForm(options: FillOptions): Promise<FillResult>;
 /** Markform version. */
 declare const VERSION = "0.1.0";
 //#endregion
-export { type AgentResponse, type ApplyResult, ApplyResultSchema, type CheckboxMode, CheckboxModeSchema, type CheckboxProgressCounts, CheckboxProgressCountsSchema, type CheckboxValue, CheckboxValueSchema, type CheckboxesField, CheckboxesFieldSchema, type CheckboxesValue, CheckboxesValueSchema, type ClearFieldPatch, ClearFieldPatchSchema, type CoerceInputContextResult, type CoercionResult, type ComputedSummaries, type DocumentationBlock, DocumentationBlockSchema, type DocumentationTag, DocumentationTagSchema, type ExplicitCheckboxValue, ExplicitCheckboxValueSchema, type Field, type FieldBase, type FieldGroup, FieldGroupSchema, type FieldKind, FieldKindSchema, type FieldProgress, FieldProgressSchema, FieldSchema, type FieldValue, FieldValueSchema, type FillOptions, type FillResult, type FillStatus, FormHarness, type FormSchema, FormSchemaSchema, type HarnessConfig, HarnessConfigSchema, type Id, type IdIndexEntry, IdSchema, type InputContext, type InspectIssue, InspectIssueSchema, type InspectOptions, type InspectResult, InspectResultSchema, type IssueReason, IssueReasonSchema, type IssueScope, IssueScopeSchema, type MarkformFrontmatter, MarkformFrontmatterSchema, MockAgent, type MultiCheckboxState, MultiCheckboxStateSchema, type MultiSelectField, MultiSelectFieldSchema, type MultiSelectValue, MultiSelectValueSchema, type NumberField, NumberFieldSchema, type NumberValue, NumberValueSchema, type Option, type OptionId, OptionIdSchema, OptionSchema, ParseError, type ParsedForm, type Patch, PatchSchema, type ProgressCounts, ProgressCountsSchema, type ProgressState, ProgressStateSchema, type ProgressSummary, ProgressSummarySchema, type QualifiedOptionRef, type RawFieldValue, type SerializeOptions, type SessionFinal, SessionFinalSchema, type SessionTranscript, SessionTranscriptSchema, type SessionTurn, SessionTurnSchema, type SessionTurnStats, type SetCheckboxesPatch, SetCheckboxesPatchSchema, type SetMultiSelectPatch, SetMultiSelectPatchSchema, type SetNumberPatch, SetNumberPatchSchema, type SetSingleSelectPatch, SetSingleSelectPatchSchema, type SetStringListPatch, SetStringListPatchSchema, type SetStringPatch, SetStringPatchSchema, type Severity, SeveritySchema, type SimpleCheckboxState, SimpleCheckboxStateSchema, type SingleSelectField, SingleSelectFieldSchema, type SingleSelectValue, SingleSelectValueSchema, type SourcePosition, SourcePositionSchema, type SourceRange, SourceRangeSchema, type StepResult, StepResultSchema, type StringField, StringFieldSchema, type StringListField, StringListFieldSchema, type StringListValue, StringListValueSchema, type StringValue, StringValueSchema, type StructureSummary, StructureSummarySchema, type TurnProgress, type TurnStats, VERSION, type ValidateOptions, type ValidateResult, type ValidationIssue, ValidationIssueSchema, type ValidatorContext, type ValidatorFn, type ValidatorRef, ValidatorRefSchema, type ValidatorRegistry, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, fillForm, findFieldById, inspect, isFormComplete, parseForm, parseSession, serialize, serializeSession, validate };
+export { type AgentResponse, type AnswerState, AnswerStateSchema, type ApplyResult, ApplyResultSchema, type CheckboxMode, CheckboxModeSchema, type CheckboxProgressCounts, CheckboxProgressCountsSchema, type CheckboxValue, CheckboxValueSchema, type CheckboxesField, CheckboxesFieldSchema, type CheckboxesValue, CheckboxesValueSchema, type ClearFieldPatch, ClearFieldPatchSchema, type CoerceInputContextResult, type CoercionResult, type ComputedSummaries, type DocumentationBlock, DocumentationBlockSchema, type DocumentationTag, DocumentationTagSchema, type ExplicitCheckboxValue, ExplicitCheckboxValueSchema, type Field, type FieldBase, type FieldGroup, FieldGroupSchema, type FieldKind, FieldKindSchema, type FieldProgress, FieldProgressSchema, type FieldResponse, FieldResponseSchema, FieldSchema, type FieldValue, FieldValueSchema, type FillOptions, type FillResult, type FillStatus, FormHarness, type FormSchema, FormSchemaSchema, type FrontmatterHarnessConfig, type HarnessConfig, HarnessConfigSchema, type Id, type IdIndexEntry, IdSchema, type InputContext, type InspectIssue, InspectIssueSchema, type InspectOptions, type InspectResult, InspectResultSchema, type IssueReason, IssueReasonSchema, type IssueScope, IssueScopeSchema, type MarkformFrontmatter, MarkformFrontmatterSchema, MockAgent, type MultiCheckboxState, MultiCheckboxStateSchema, type MultiSelectField, MultiSelectFieldSchema, type MultiSelectValue, MultiSelectValueSchema, type NodeType, type NumberField, NumberFieldSchema, type NumberValue, NumberValueSchema, type Option, type OptionId, OptionIdSchema, OptionSchema, ParseError, type ParsedForm, type Patch, PatchSchema, type ProgressCounts, ProgressCountsSchema, type ProgressState, ProgressStateSchema, type ProgressSummary, ProgressSummarySchema, type QualifiedOptionRef, type RawFieldValue, type ResearchOptions, type ResearchResult, type ResearchStatus, type SerializeOptions, type SessionFinal, SessionFinalSchema, type SessionTranscript, SessionTranscriptSchema, type SessionTurn, SessionTurnSchema, type SessionTurnStats, type SetCheckboxesPatch, SetCheckboxesPatchSchema, type SetMultiSelectPatch, SetMultiSelectPatchSchema, type SetNumberPatch, SetNumberPatchSchema, type SetSingleSelectPatch, SetSingleSelectPatchSchema, type SetStringListPatch, SetStringListPatchSchema, type SetStringPatch, SetStringPatchSchema, type Severity, SeveritySchema, type SimpleCheckboxState, SimpleCheckboxStateSchema, type SingleSelectField, SingleSelectFieldSchema, type SingleSelectValue, SingleSelectValueSchema, type SourcePosition, SourcePositionSchema, type SourceRange, SourceRangeSchema, type StepResult, StepResultSchema, type StringField, StringFieldSchema, type StringListField, StringListFieldSchema, type StringListValue, StringListValueSchema, type StringValue, StringValueSchema, type StructureSummary, StructureSummarySchema, type TurnProgress, type TurnStats, VERSION, type ValidateOptions, type ValidateResult, type ValidationIssue, ValidationIssueSchema, type ValidatorContext, type ValidatorFn, type ValidatorRef, ValidatorRefSchema, type ValidatorRegistry, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, fillForm, findFieldById, inspect, isFormComplete, isResearchForm, parseForm, parseSession, resolveHarnessConfig, runResearch, serialize, serializeSession, validate, validateResearchForm };

package/dist/index.mjs

@@ -1,4 +1,6 @@
-import { $ as OptionSchema, A as ClearFieldPatchSchema, B as HarnessConfigSchema, Ct as StringValueSchema, D as CheckboxValueSchema, E as CheckboxProgressCountsSchema, Et as ValidatorRefSchema, F as FieldKindSchema, G as IssueScopeSchema, H as InspectIssueSchema, I as FieldProgressSchema, J as MultiSelectFieldSchema, K as MarkformFrontmatterSchema, L as FieldSchema, M as DocumentationTagSchema, N as ExplicitCheckboxValueSchema, O as CheckboxesFieldSchema, P as FieldGroupSchema, Q as OptionIdSchema, R as FieldValueSchema, St as StringListValueSchema, T as CheckboxModeSchema, Tt as ValidationIssueSchema, U as InspectResultSchema, V as IdSchema, W as IssueReasonSchema, X as NumberFieldSchema, Y as MultiSelectValueSchema, Z as NumberValueSchema, _t as SourcePositionSchema, a as computeAllSummaries, at as SessionTranscriptSchema, bt as StringFieldSchema, c as computeStructureSummary, ct as SetMultiSelectPatchSchema, dt as SetStringListPatchSchema, et as PatchSchema, ft as SetStringPatchSchema, gt as SingleSelectValueSchema, ht as SingleSelectFieldSchema, i as validate, it as SessionFinalSchema, j as DocumentationBlockSchema, k as CheckboxesValueSchema, l as isFormComplete, lt as SetNumberPatchSchema, mt as SimpleCheckboxStateSchema, nt as ProgressStateSchema, o as computeFormState, ot as SessionTurnSchema, pt as SeveritySchema, q as MultiCheckboxStateSchema, r as inspect, rt as ProgressSummarySchema, s as computeProgressSummary, st as SetCheckboxesPatchSchema, t as applyPatches, tt as ProgressCountsSchema, u as serialize, ut as SetSingleSelectPatchSchema, vt as SourceRangeSchema, w as ApplyResultSchema, wt as StructureSummarySchema, xt as StringListFieldSchema, yt as StepResultSchema, z as FormSchemaSchema } from "./apply-BQdd-fdx.mjs";
-import { _ as parseForm, c as createMockAgent, d as coerceInputContext, f as coerceToFieldPatch, g as ParseError, h as serializeSession, l as FormHarness, m as parseSession, n as fillForm, p as findFieldById, s as MockAgent, t as VERSION, u as createHarness } from "./src-Cs4_9lWP.mjs";
+import { $ as StringFieldSchema, A as NumberValueSchema, B as SetCheckboxesPatchSchema, C as IssueReasonSchema, D as MultiSelectFieldSchema, E as MultiCheckboxStateSchema, F as ProgressStateSchema, G as SetStringPatchSchema, H as SetNumberPatchSchema, I as ProgressSummarySchema, J as SingleSelectFieldSchema, K as SeveritySchema, L as SessionFinalSchema, M as OptionSchema, N as PatchSchema, O as MultiSelectValueSchema, P as ProgressCountsSchema, Q as StepResultSchema, R as SessionTranscriptSchema, S as InspectResultSchema, T as MarkformFrontmatterSchema, U as SetSingleSelectPatchSchema, V as SetMultiSelectPatchSchema, W as SetStringListPatchSchema, X as SourcePositionSchema, Y as SingleSelectValueSchema, Z as SourceRangeSchema, _ as FieldValueSchema, a as CheckboxValueSchema, at as ValidatorRefSchema, b as IdSchema, c as ClearFieldPatchSchema, d as ExplicitCheckboxValueSchema, et as StringListFieldSchema, f as FieldGroupSchema, g as FieldSchema, h as FieldResponseSchema, i as CheckboxProgressCountsSchema, it as ValidationIssueSchema, j as OptionIdSchema, k as NumberFieldSchema, l as DocumentationBlockSchema, m as FieldProgressSchema, n as ApplyResultSchema, nt as StringValueSchema, o as CheckboxesFieldSchema, p as FieldKindSchema, q as SimpleCheckboxStateSchema, r as CheckboxModeSchema, rt as StructureSummarySchema, s as CheckboxesValueSchema, t as AnswerStateSchema, tt as StringListValueSchema, u as DocumentationTagSchema, v as FormSchemaSchema, w as IssueScopeSchema, x as InspectIssueSchema, y as HarnessConfigSchema, z as SessionTurnSchema } from "./coreTypes-Dful87E0.mjs";
+import { a as computeAllSummaries, c as computeStructureSummary, i as validate, l as isFormComplete, o as computeFormState, r as inspect, s as computeProgressSummary, t as applyPatches, u as serialize } from "./apply-BfAGTHMh.mjs";
+import { _ as findFieldById, a as resolveHarnessConfig, d as MockAgent, f as createMockAgent, g as coerceToFieldPatch, h as coerceInputContext, i as runResearch, m as createHarness, n as isResearchForm, o as fillForm, p as FormHarness, r as validateResearchForm, t as VERSION, v as parseForm, y as ParseError } from "./src-BXRkGFpG.mjs";
+import { n as serializeSession, t as parseSession } from "./session-Bqnwi9wp.mjs";
 
-export { ApplyResultSchema, CheckboxModeSchema, CheckboxProgressCountsSchema, CheckboxValueSchema, CheckboxesFieldSchema, CheckboxesValueSchema, ClearFieldPatchSchema, DocumentationBlockSchema, DocumentationTagSchema, ExplicitCheckboxValueSchema, FieldGroupSchema, FieldKindSchema, FieldProgressSchema, FieldSchema, FieldValueSchema, FormHarness, FormSchemaSchema, HarnessConfigSchema, IdSchema, InspectIssueSchema, InspectResultSchema, IssueReasonSchema, IssueScopeSchema, MarkformFrontmatterSchema, MockAgent, MultiCheckboxStateSchema, MultiSelectFieldSchema, MultiSelectValueSchema, NumberFieldSchema, NumberValueSchema, OptionIdSchema, OptionSchema, ParseError, PatchSchema, ProgressCountsSchema, ProgressStateSchema, ProgressSummarySchema, SessionFinalSchema, SessionTranscriptSchema, SessionTurnSchema, SetCheckboxesPatchSchema, SetMultiSelectPatchSchema, SetNumberPatchSchema, SetSingleSelectPatchSchema, SetStringListPatchSchema, SetStringPatchSchema, SeveritySchema, SimpleCheckboxStateSchema, SingleSelectFieldSchema, SingleSelectValueSchema, SourcePositionSchema, SourceRangeSchema, StepResultSchema, StringFieldSchema, StringListFieldSchema, StringListValueSchema, StringValueSchema, StructureSummarySchema, VERSION, ValidationIssueSchema, ValidatorRefSchema, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, fillForm, findFieldById, inspect, isFormComplete, parseForm, parseSession, serialize, serializeSession, validate };
+export { AnswerStateSchema, ApplyResultSchema, CheckboxModeSchema, CheckboxProgressCountsSchema, CheckboxValueSchema, CheckboxesFieldSchema, CheckboxesValueSchema, ClearFieldPatchSchema, DocumentationBlockSchema, DocumentationTagSchema, ExplicitCheckboxValueSchema, FieldGroupSchema, FieldKindSchema, FieldProgressSchema, FieldResponseSchema, FieldSchema, FieldValueSchema, FormHarness, FormSchemaSchema, HarnessConfigSchema, IdSchema, InspectIssueSchema, InspectResultSchema, IssueReasonSchema, IssueScopeSchema, MarkformFrontmatterSchema, MockAgent, MultiCheckboxStateSchema, MultiSelectFieldSchema, MultiSelectValueSchema, NumberFieldSchema, NumberValueSchema, OptionIdSchema, OptionSchema, ParseError, PatchSchema, ProgressCountsSchema, ProgressStateSchema, ProgressSummarySchema, SessionFinalSchema, SessionTranscriptSchema, SessionTurnSchema, SetCheckboxesPatchSchema, SetMultiSelectPatchSchema, SetNumberPatchSchema, SetSingleSelectPatchSchema, SetStringListPatchSchema, SetStringPatchSchema, SeveritySchema, SimpleCheckboxStateSchema, SingleSelectFieldSchema, SingleSelectValueSchema, SourcePositionSchema, SourceRangeSchema, StepResultSchema, StringFieldSchema, StringListFieldSchema, StringListValueSchema, StringValueSchema, StructureSummarySchema, VERSION, ValidationIssueSchema, ValidatorRefSchema, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, fillForm, findFieldById, inspect, isFormComplete, isResearchForm, parseForm, parseSession, resolveHarnessConfig, runResearch, serialize, serializeSession, validate, validateResearchForm };

package/dist/session-Bqnwi9wp.mjs

@@ -0,0 +1,110 @@
+import { R as SessionTranscriptSchema } from "./coreTypes-Dful87E0.mjs";
+import YAML from "yaml";
+
+//#region src/engine/session.ts
+/**
+* Session module - parsing and serializing session transcripts.
+*
+* Session transcripts are used for golden testing and session replay.
+* They capture the full interaction between the harness and agent.
+*/
+/**
+* Parse a session transcript from YAML string.
+*
+* Converts snake_case keys to camelCase for TypeScript consumption.
+*
+* @param yaml - YAML string containing session transcript
+* @returns Parsed and validated SessionTranscript
+* @throws Error if YAML is invalid or doesn't match schema
+*/
+function parseSession(yaml) {
+	let raw;
+	try {
+		raw = YAML.parse(yaml);
+	} catch (err) {
+		throw new Error(`Failed to parse session YAML: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	const converted = toCamelCaseDeep(raw);
+	const result = SessionTranscriptSchema.safeParse(converted);
+	if (!result.success) {
+		const errors = result.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+		throw new Error(`Invalid session transcript: ${errors}`);
+	}
+	return result.data;
+}
+/**
+* Serialize a session transcript to YAML string.
+*
+* Converts camelCase keys to snake_case for YAML output.
+*
+* @param session - Session transcript to serialize
+* @returns YAML string
+*/
+function serializeSession(session) {
+	const snakeCased = toSnakeCaseDeep(session);
+	return YAML.stringify(snakeCased, {
+		indent: 2,
+		lineWidth: 0
+	});
+}
+/**
+* Convert a string from snake_case to camelCase.
+*/
+function snakeToCamel(str) {
+	return str.replace(/_([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
+/**
+* Convert a string from camelCase to snake_case.
+*/
+function camelToSnake(str) {
+	return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+/**
+* Recursively convert all object keys from snake_case to camelCase.
+*
+* Preserves keys that are user-defined identifiers (like option IDs in
+* checkboxes `values` objects).
+*
+* @param obj - Object to convert
+* @param preserveKeys - If true, don't convert keys in this object (but still recurse into values)
+*/
+function toCamelCaseDeep(obj, preserveKeys = false) {
+	if (obj === null || obj === void 0) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => toCamelCaseDeep(item, false));
+	if (typeof obj === "object") {
+		const result = {};
+		const record = obj;
+		for (const [key, value] of Object.entries(record)) {
+			const resultKey = preserveKeys ? key : snakeToCamel(key);
+			result[resultKey] = toCamelCaseDeep(value, key === "values" && record.op === "set_checkboxes");
+		}
+		return result;
+	}
+	return obj;
+}
+/**
+* Recursively convert all object keys from camelCase to snake_case.
+*
+* Preserves keys that are user-defined identifiers (like option IDs in
+* checkboxes `values` objects).
+*
+* @param obj - Object to convert
+* @param preserveKeys - If true, don't convert keys in this object (but still recurse into values)
+*/
+function toSnakeCaseDeep(obj, preserveKeys = false) {
+	if (obj === null || obj === void 0) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => toSnakeCaseDeep(item, false));
+	if (typeof obj === "object") {
+		const result = {};
+		const record = obj;
+		for (const [key, value] of Object.entries(record)) {
+			const resultKey = preserveKeys ? key : camelToSnake(key);
+			result[resultKey] = toSnakeCaseDeep(value, key === "values" && record.op === "set_checkboxes");
+		}
+		return result;
+	}
+	return obj;
+}
+
+//#endregion
+export { serializeSession as n, parseSession as t };

package/dist/session-DdAtY2Ni.mjs

@@ -0,0 +1,4 @@
+import "./coreTypes-Dful87E0.mjs";
+import { n as serializeSession, t as parseSession } from "./session-Bqnwi9wp.mjs";
+
+export { serializeSession };

package/dist/shared-D7gf27Tr.mjs

@@ -0,0 +1,3 @@
+import { a as getCommandContext, c as logInfo, d as logVerbose, f as logWarn, h as writeFile, i as formatPath, l as logSuccess, m as shouldUseColors, n as ensureFormsDir, o as logDryRun, p as readFile, r as formatOutput, s as logError, t as OUTPUT_FORMATS, u as logTiming } from "./shared-N_s1M-_K.mjs";
+
+export { writeFile };

package/dist/shared-N_s1M-_K.mjs

@@ -0,0 +1,176 @@
+import YAML from "yaml";
+import { relative } from "node:path";
+import pc from "picocolors";
+import { mkdir } from "node:fs/promises";
+
+//#region src/cli/lib/naming.ts
+/**
+* Naming convention utilities for JSON/YAML output.
+*
+* Converts between camelCase (TypeScript internal) and snake_case (JSON/YAML output).
+*/
+/**
+* Convert a camelCase string to snake_case.
+*
+* @example
+* toSnakeCase("fieldCount") // "field_count"
+* toSnakeCase("parentFieldId") // "parent_field_id"
+* toSnakeCase("already_snake") // "already_snake"
+*/
+function toSnakeCase(str) {
+	return str.replace(/([A-Z])/g, "_$1").toLowerCase();
+}
+/**
+* Recursively convert all object keys from camelCase to snake_case.
+*
+* Handles nested objects and arrays. Primitives are returned unchanged.
+*/
+function convertKeysToSnakeCase(obj) {
+	if (obj === null || obj === void 0) return obj;
+	if (Array.isArray(obj)) return obj.map(convertKeysToSnakeCase);
+	if (typeof obj === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(obj)) {
+			const snakeKey = toSnakeCase(key);
+			result[snakeKey] = convertKeysToSnakeCase(value);
+		}
+		return result;
+	}
+	return obj;
+}
+
+//#endregion
+//#region src/cli/lib/shared.ts
+/**
+* Valid format options for Commander choice validation.
+*/
+const OUTPUT_FORMATS = [
+	"console",
+	"plaintext",
+	"yaml",
+	"json",
+	"markform",
+	"markdown"
+];
+/**
+* Extract command context from Commander options.
+*/
+function getCommandContext(command) {
+	const opts = command.optsWithGlobals();
+	return {
+		dryRun: opts.dryRun ?? false,
+		verbose: opts.verbose ?? false,
+		quiet: opts.quiet ?? false,
+		format: opts.format ?? "console",
+		formsDir: opts.formsDir
+	};
+}
+/**
+* Check if output should use colors.
+* Returns true for console format when stdout is a TTY.
+*/
+function shouldUseColors(ctx) {
+	if (ctx.format === "plaintext" || ctx.format === "yaml" || ctx.format === "json") return false;
+	return process.stdout.isTTY && !process.env.NO_COLOR;
+}
+/**
+* Format structured data according to output format.
+*
+* JSON and YAML outputs are converted to snake_case keys for consistency.
+*/
+function formatOutput(ctx, data, consoleFormatter) {
+	switch (ctx.format) {
+		case "json": return JSON.stringify(convertKeysToSnakeCase(data), null, 2);
+		case "yaml": return YAML.stringify(convertKeysToSnakeCase(data));
+		case "plaintext":
+		case "console":
+		default:
+			if (consoleFormatter) return consoleFormatter(data, shouldUseColors(ctx));
+			return YAML.stringify(convertKeysToSnakeCase(data));
+	}
+}
+/**
+* Log a dry-run message.
+*/
+function logDryRun(message, details) {
+	console.log(pc.yellow(`[DRY RUN] ${message}`));
+	if (details) console.log(pc.dim(JSON.stringify(details, null, 2)));
+}
+/**
+* Log a verbose message (only shown if --verbose is set).
+*/
+function logVerbose(ctx, message) {
+	if (ctx.verbose) console.log(pc.dim(message));
+}
+/**
+* Log an info message (hidden if --quiet is set).
+*/
+function logInfo(ctx, message) {
+	if (!ctx.quiet) console.log(message);
+}
+/**
+* Log an error message (always shown).
+*/
+function logError(message) {
+	console.error(pc.red(`Error: ${message}`));
+}
+/**
+* Log a success message (hidden if --quiet is set).
+*/
+function logSuccess(ctx, message) {
+	if (!ctx.quiet) console.log(pc.green(message));
+}
+/**
+* Log a timing message (hidden if --quiet is set).
+*/
+function logTiming(ctx, label, durationMs) {
+	if (!ctx.quiet) {
+		const seconds = (durationMs / 1e3).toFixed(1);
+		console.log(pc.cyan(`⏰ ${label}: ${seconds}s`));
+	}
+}
+/**
+* Log a warning message (hidden if --quiet is set).
+*/
+function logWarn(ctx, message) {
+	if (!ctx.quiet) console.log(pc.yellow(`⚠️  ${message}`));
+}
+/**
+* Format a file path for display: relative to cwd, colored green.
+* If the path is within the cwd, shows as relative (e.g., "./simple-filled1.form.md")
+* If outside cwd, shows the absolute path.
+*/
+function formatPath(absolutePath, cwd = process.cwd()) {
+	const relativePath = relative(cwd, absolutePath);
+	const displayPath = relativePath.startsWith("..") ? absolutePath : `./${relativePath}`;
+	return pc.green(displayPath);
+}
+/**
+* Read a file and return its contents.
+*/
+async function readFile$1(filePath) {
+	const { readFile: fsReadFile } = await import("node:fs/promises");
+	return fsReadFile(filePath, "utf-8");
+}
+/**
+* Write contents to a file atomically.
+*
+* Uses the atomically library to prevent partial or corrupted files
+* if the process crashes mid-write.
+*/
+async function writeFile(filePath, contents) {
+	const { writeFile: atomicWriteFile } = await import("atomically");
+	await atomicWriteFile(filePath, contents);
+}
+/**
+* Ensure the forms directory exists, creating it if necessary.
+* Uses recursive mkdir so parent directories are created as needed.
+*
+* @param formsDir Absolute path to the forms directory
+*/
+async function ensureFormsDir(formsDir) {
+	await mkdir(formsDir, { recursive: true });
+}
+
+//#endregion
+export { getCommandContext as a, logInfo as c, logVerbose as d, logWarn as f, writeFile as h, formatPath as i, logSuccess as l, shouldUseColors as m, ensureFormsDir as n, logDryRun as o, readFile$1 as p, formatOutput as r, logError as s, OUTPUT_FORMATS as t, logTiming as u };