markform 0.1.0 → 0.1.2

package/dist/cli-9fvFySww.mjs

@@ -1,2564 +0,0 @@
-import { $ as PatchSchema, S as parseRolesFlag, b as USER_ROLE, d as serializeRawMarkdown, f as AGENT_ROLE, g as DEFAULT_PORT, h as DEFAULT_MAX_TURNS, m as DEFAULT_MAX_PATCHES_PER_TURN, p as DEFAULT_MAX_ISSUES, r as inspect, t as applyPatches, u as serialize, x as formatSuggestedLlms, y as SUGGESTED_LLMS } from "./apply-C0vjijlP.mjs";
-import { _ as parseForm, a as resolveModel, c as createMockAgent, h as serializeSession, i as getProviderNames, o as createLiveAgent, r as getProviderInfo, t as VERSION, u as createHarness } from "./src-DBD3Dt4f.mjs";
-import YAML from "yaml";
-import { Command } from "commander";
-import pc from "picocolors";
-import { basename, dirname, join, relative, resolve } from "node:path";
-import * as p from "@clack/prompts";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { exec } from "node:child_process";
-import { createServer } from "node:http";
-
-//#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"
-	};
-}
-/**
-* 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(filePath) {
-	const { readFile: fsReadFile } = await import("node:fs/promises");
-	return fsReadFile(filePath, "utf-8");
-}
-/**
-* Write contents to a file.
-*/
-async function writeFile(filePath, contents) {
-	const { writeFile: fsWriteFile } = await import("node:fs/promises");
-	await fsWriteFile(filePath, contents, "utf-8");
-}
-
-//#endregion
-//#region src/cli/commands/apply.ts
-/**
-* Format state badge for console output.
-*/
-function formatState$2(state, useColors) {
-	const [text, colorFn] = {
-		complete: ["✓ complete", pc.green],
-		incomplete: ["○ incomplete", pc.yellow],
-		empty: ["◌ empty", pc.dim],
-		invalid: ["✗ invalid", pc.red]
-	}[state] ?? [state, (s) => s];
-	return useColors ? colorFn(text) : text;
-}
-/**
-* Format apply report for console output.
-*/
-function formatConsoleReport$2(report, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	const dim = useColors ? pc.dim : (s) => s;
-	const cyan = useColors ? pc.cyan : (s) => s;
-	const green = useColors ? pc.green : (s) => s;
-	const red = useColors ? pc.red : (s) => s;
-	lines.push(bold(cyan("Apply Result")));
-	lines.push("");
-	const statusColor = report.apply_status === "applied" ? green : red;
-	lines.push(`${bold("Status:")} ${statusColor(report.apply_status)}`);
-	lines.push(`${bold("Form State:")} ${formatState$2(report.form_state, useColors)}`);
-	lines.push(`${bold("Complete:")} ${report.is_complete ? green("yes") : dim("no")}`);
-	lines.push("");
-	const counts = report.progress.counts;
-	lines.push(bold("Progress:"));
-	lines.push(`  Total fields: ${counts.totalFields}`);
-	lines.push(`  Complete: ${counts.completeFields}`);
-	lines.push(`  Incomplete: ${counts.incompleteFields}`);
-	lines.push(`  Empty (required): ${counts.emptyRequiredFields}`);
-	lines.push("");
-	if (report.issues.length > 0) {
-		lines.push(bold(`Issues (${report.issues.length}):`));
-		for (const issue of report.issues) {
-			const priority = `P${issue.priority}`;
-			lines.push(`  ${dim(priority)} ${dim(issue.ref)}: ${issue.message}`);
-		}
-	} else lines.push(dim("No issues."));
-	return lines.join("\n");
-}
-/**
-* Register the apply command.
-*/
-function registerApplyCommand(program) {
-	program.command("apply <file>").description("Apply patches to a form").option("--patch <json>", "JSON array of patches to apply").option("-o, --output <file>", "Output file (defaults to stdout)").option("--report", "Output apply result report instead of modified form").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		try {
-			if (!options.patch) {
-				logError("--patch option is required");
-				process.exit(1);
-			}
-			logVerbose(ctx, `Reading file: ${file}`);
-			const content = await readFile(file);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			logVerbose(ctx, "Parsing patches...");
-			let parsedJson;
-			try {
-				parsedJson = JSON.parse(options.patch);
-			} catch {
-				logError("Invalid JSON in --patch option");
-				process.exit(1);
-			}
-			if (!Array.isArray(parsedJson)) {
-				logError("--patch must be a JSON array");
-				process.exit(1);
-			}
-			const patches = parsedJson;
-			const validatedPatches = [];
-			for (let i = 0; i < patches.length; i++) {
-				const result$1 = PatchSchema.safeParse(patches[i]);
-				if (!result$1.success) {
-					logError(`Invalid patch at index ${i}: ${result$1.error.issues[0]?.message ?? "Unknown error"}`);
-					process.exit(1);
-				}
-				validatedPatches.push(result$1.data);
-			}
-			if (ctx.dryRun) {
-				logDryRun(`Would apply ${validatedPatches.length} patches to ${file}`, { patches: validatedPatches });
-				return;
-			}
-			logVerbose(ctx, `Applying ${validatedPatches.length} patches...`);
-			const result = applyPatches(form, validatedPatches);
-			if (result.applyStatus === "rejected") {
-				logError("Patches rejected - structural validation failed");
-				const output = formatOutput(ctx, {
-					apply_status: result.applyStatus,
-					form_state: result.formState,
-					is_complete: result.isComplete,
-					structure: result.structureSummary,
-					progress: result.progressSummary,
-					issues: result.issues
-				}, (data, useColors) => formatConsoleReport$2(data, useColors));
-				console.error(output);
-				process.exit(1);
-			}
-			if (options.report) {
-				const output = formatOutput(ctx, {
-					apply_status: result.applyStatus,
-					form_state: result.formState,
-					is_complete: result.isComplete,
-					structure: result.structureSummary,
-					progress: result.progressSummary,
-					issues: result.issues
-				}, (data, useColors) => formatConsoleReport$2(data, useColors));
-				if (options.output) {
-					await writeFile(options.output, output);
-					logSuccess(ctx, `Report written to ${options.output}`);
-				} else console.log(output);
-			} else {
-				const output = serialize(form);
-				if (options.output) {
-					await writeFile(options.output, output);
-					logSuccess(ctx, `Modified form written to ${options.output}`);
-				} else console.log(output);
-			}
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/dump.ts
-/**
-* Format a field value for console display.
-*/
-function formatFieldValue$1(value, useColors) {
-	const dim = useColors ? pc.dim : (s) => s;
-	const green = useColors ? pc.green : (s) => s;
-	if (!value) return dim("(empty)");
-	switch (value.kind) {
-		case "string": return value.value ? green(`"${value.value}"`) : dim("(empty)");
-		case "number": return value.value !== null ? green(String(value.value)) : dim("(empty)");
-		case "string_list": return value.items.length > 0 ? green(`[${value.items.join(", ")}]`) : dim("(empty)");
-		case "single_select": return value.selected ? green(value.selected) : dim("(none selected)");
-		case "multi_select": return value.selected.length > 0 ? green(`[${value.selected.join(", ")}]`) : dim("(none selected)");
-		case "checkboxes": {
-			const entries = Object.entries(value.values);
-			if (entries.length === 0) return dim("(no entries)");
-			return entries.map(([k, v]) => `${k}:${v}`).join(", ");
-		}
-		default: return dim("(unknown)");
-	}
-}
-/**
-* Format values for console output.
-*/
-function formatConsoleValues(values, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	for (const [fieldId, value] of Object.entries(values)) {
-		const valueStr = formatFieldValue$1(value, useColors);
-		lines.push(`${bold(fieldId)}: ${valueStr}`);
-	}
-	if (lines.length === 0) {
-		const dim = useColors ? pc.dim : (s) => s;
-		lines.push(dim("(no values)"));
-	}
-	return lines.join("\n");
-}
-/**
-* Convert FieldValue to a plain value for JSON/YAML serialization.
-*/
-function toPlainValue(value) {
-	switch (value.kind) {
-		case "string": return value.value ?? null;
-		case "number": return value.value ?? null;
-		case "string_list": return value.items;
-		case "single_select": return value.selected ?? null;
-		case "multi_select": return value.selected;
-		case "checkboxes": return value.values;
-		default: return null;
-	}
-}
-/**
-* Register the dump command.
-*/
-function registerDumpCommand(program) {
-	program.command("dump <file>").description("Extract and display form values only (lightweight inspect)").action(async (file, _options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		try {
-			logVerbose(ctx, `Reading file: ${file}`);
-			const content = await readFile(file);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			if (ctx.format === "json" || ctx.format === "yaml") {
-				const plainValues = {};
-				for (const [fieldId, value] of Object.entries(form.valuesByFieldId)) plainValues[fieldId] = toPlainValue(value);
-				const output = formatOutput(ctx, plainValues, () => "");
-				console.log(output);
-			} else {
-				const output = formatOutput(ctx, form.valuesByFieldId, (data, useColors) => formatConsoleValues(data, useColors));
-				console.log(output);
-			}
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/lib/exportHelpers.ts
-/**
-* Export helpers for multi-format form output.
-*
-* Provides reusable functions for exporting forms to multiple formats:
-* - Markform format (.form.md) - canonical form with directives
-* - Raw markdown (.raw.md) - plain readable markdown
-* - YAML values (.yml) - extracted field values
-*/
-/**
-* Convert field values to plain values for YAML export.
-*
-* Extracts the underlying values from the typed FieldValue wrappers
-* for a cleaner YAML representation.
-*/
-function toPlainValues(form) {
-	const result = {};
-	for (const [fieldId, value] of Object.entries(form.valuesByFieldId)) switch (value.kind) {
-		case "string":
-			result[fieldId] = value.value ?? null;
-			break;
-		case "number":
-			result[fieldId] = value.value ?? null;
-			break;
-		case "string_list":
-			result[fieldId] = value.items;
-			break;
-		case "single_select":
-			result[fieldId] = value.selected ?? null;
-			break;
-		case "multi_select":
-			result[fieldId] = value.selected;
-			break;
-		case "checkboxes":
-			result[fieldId] = value.values;
-			break;
-	}
-	return result;
-}
-/**
-* Derive export paths from a base form path.
-*
-* @param basePath - Path to the .form.md file
-* @returns Object with paths for all export formats
-*/
-function deriveExportPaths(basePath) {
-	return {
-		formPath: basePath,
-		rawPath: basePath.replace(/\.form\.md$/, ".raw.md"),
-		yamlPath: basePath.replace(/\.form\.md$/, ".yml")
-	};
-}
-/**
-* Export form to multiple formats.
-*
-* Writes:
-* - Markform format (.form.md) - canonical form with directives
-* - Raw markdown (.raw.md) - plain readable markdown (no directives)
-* - YAML values (.yml) - extracted field values only
-*
-* @param form - The parsed form to export
-* @param basePath - Base path for the .form.md file (other paths are derived)
-* @returns Paths to all exported files
-*/
-function exportMultiFormat(form, basePath) {
-	const paths = deriveExportPaths(basePath);
-	const formContent = serialize(form);
-	writeFileSync(paths.formPath, formContent, "utf-8");
-	const rawContent = serializeRawMarkdown(form);
-	writeFileSync(paths.rawPath, rawContent, "utf-8");
-	const values = toPlainValues(form);
-	const yamlContent = YAML.stringify(values);
-	writeFileSync(paths.yamlPath, yamlContent, "utf-8");
-	return paths;
-}
-
-//#endregion
-//#region src/cli/examples/exampleRegistry.ts
-/**
-* Example form registry.
-* Provides form content from the examples directory for the examples CLI command.
-*/
-/** Example definitions without content - content is loaded lazily. */
-const EXAMPLE_DEFINITIONS = [
-	{
-		id: "simple",
-		title: "Simple Test Form",
-		description: "User and agent roles for testing full workflow. User fills required fields, agent fills optional.",
-		filename: "simple.form.md",
-		path: "simple/simple.form.md"
-	},
-	{
-		id: "political-research",
-		title: "Political Research",
-		description: "Biographical research form with one user field (name) and agent-filled details. Uses web search.",
-		filename: "political-research.form.md",
-		path: "political-research/political-research.form.md"
-	},
-	{
-		id: "earnings-analysis",
-		title: "Company Quarterly Analysis",
-		description: "Financial analysis with one user field (company) and agent-filled quarterly analysis sections.",
-		filename: "earnings-analysis.form.md",
-		path: "earnings-analysis/earnings-analysis.form.md"
-	}
-];
-/**
-* Get the path to the examples directory.
-* Works both during development and when installed as a package.
-*/
-function getExamplesDir() {
-	const thisDir = dirname(fileURLToPath(import.meta.url));
-	if (thisDir.split(/[/\\]/).pop() === "dist") return join(dirname(thisDir), "examples");
-	return join(dirname(dirname(dirname(thisDir))), "examples");
-}
-/**
-* Load the content of an example form.
-* @param exampleId - The example ID (e.g., 'simple', 'political-research')
-* @returns The form content as a string
-* @throws Error if the example is not found
-*/
-function loadExampleContent(exampleId) {
-	const example = EXAMPLE_DEFINITIONS.find((e) => e.id === exampleId);
-	if (!example) throw new Error(`Unknown example: ${exampleId}`);
-	const filePath = join(getExamplesDir(), example.path);
-	try {
-		return readFileSync(filePath, "utf-8");
-	} catch (error) {
-		throw new Error(`Failed to load example '${exampleId}' from ${filePath}: ${error}`);
-	}
-}
-/**
-* Get an example definition by ID.
-*/
-function getExampleById(id) {
-	return EXAMPLE_DEFINITIONS.find((e) => e.id === id);
-}
-
-//#endregion
-//#region src/cli/lib/versioning.ts
-/**
-* Versioned filename utilities for form output.
-*
-* Generates versioned filenames to avoid overwriting existing files.
-* Pattern: name.form.md → name-filled1.form.md → name-filled2.form.md
-*/
-/**
-* Version pattern that matches -filledN or _filledN before the extension.
-* Also matches legacy -vN pattern for backwards compatibility.
-*/
-const VERSION_PATTERN = /^(.+?)(?:[-_]?(?:filled|v)(\d+))?(\.form\.md)$/i;
-/**
-* Extension pattern for fallback matching.
-*/
-const EXTENSION_PATTERN = /^(.+)(\.form\.md)$/i;
-/**
-* Parse a versioned filename into its components.
-*
-* @param filePath - Path to parse
-* @returns Parsed components or null if not a valid form file
-*/
-function parseVersionedPath(filePath) {
-	const match = VERSION_PATTERN.exec(filePath);
-	if (match) {
-		const base = match[1];
-		const versionStr = match[2];
-		const ext = match[3];
-		if (base !== void 0 && ext !== void 0) return {
-			base,
-			version: versionStr ? parseInt(versionStr, 10) : null,
-			extension: ext
-		};
-	}
-	const extMatch = EXTENSION_PATTERN.exec(filePath);
-	if (extMatch) {
-		const base = extMatch[1];
-		const ext = extMatch[2];
-		if (base !== void 0 && ext !== void 0) return {
-			base,
-			version: null,
-			extension: ext
-		};
-	}
-	return null;
-}
-/**
-* Generate a versioned filename that doesn't conflict with existing files.
-*
-* Starts from the incremented version and keeps incrementing until
-* a non-existent filename is found.
-*
-* @param filePath - Original file path
-* @returns Path to a non-existent versioned file
-*/
-function generateVersionedPath(filePath) {
-	const parsed = parseVersionedPath(filePath);
-	if (!parsed) {
-		let candidate$1 = `${filePath}-filled1`;
-		let version$1 = 1;
-		while (existsSync(candidate$1)) {
-			version$1++;
-			candidate$1 = `${filePath}-filled${version$1}`;
-		}
-		return candidate$1;
-	}
-	let version = parsed.version !== null ? parsed.version + 1 : 1;
-	let candidate = `${parsed.base}-filled${version}${parsed.extension}`;
-	while (existsSync(candidate)) {
-		version++;
-		candidate = `${parsed.base}-filled${version}${parsed.extension}`;
-	}
-	return candidate;
-}
-
-//#endregion
-//#region src/cli/lib/interactivePrompts.ts
-/**
-* Interactive prompts module for console-based form filling.
-*
-* Uses @clack/prompts to provide a rich terminal UI for users to
-* fill form fields interactively.
-*/
-/**
-* Get field description from form docs.
-*/
-function getFieldDescription(form, fieldId) {
-	return form.docs.find((d) => d.ref === fieldId && (d.tag === "description" || d.tag === "instructions"))?.bodyMarkdown;
-}
-/**
-* Get a field by ID from the form schema.
-*/
-function getFieldById(form, fieldId) {
-	for (const group of form.schema.groups) {
-		const field = group.children.find((f) => f.id === fieldId);
-		if (field) return field;
-	}
-}
-/**
-* Format field label with required indicator and progress.
-*/
-function formatFieldLabel(ctx) {
-	const required = ctx.field.required ? pc.red("*") : "";
-	const progress = pc.dim(`(${ctx.index} of ${ctx.total})`);
-	return `${ctx.field.label}${required} ${progress}`;
-}
-/**
-* Prompt for a string field value.
-*/
-async function promptForString(ctx) {
-	const field = ctx.field;
-	const currentVal = ctx.currentValue?.kind === "string" ? ctx.currentValue.value : null;
-	const result = await p.text({
-		message: formatFieldLabel(ctx),
-		placeholder: currentVal ?? (ctx.description ? ctx.description.slice(0, 60) : void 0),
-		initialValue: currentVal ?? "",
-		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (field.minLength && value.length < field.minLength) return `Minimum ${field.minLength} characters required`;
-			if (field.maxLength && value.length > field.maxLength) return `Maximum ${field.maxLength} characters allowed`;
-			if (field.pattern && !new RegExp(field.pattern).test(value)) return `Must match pattern: ${field.pattern}`;
-		}
-	});
-	if (p.isCancel(result)) return null;
-	if (!result && !field.required) return null;
-	return {
-		op: "set_string",
-		fieldId: field.id,
-		value: result || null
-	};
-}
-/**
-* Prompt for a number field value.
-*/
-async function promptForNumber(ctx) {
-	const field = ctx.field;
-	const currentVal = ctx.currentValue?.kind === "number" ? ctx.currentValue.value : null;
-	const result = await p.text({
-		message: formatFieldLabel(ctx),
-		placeholder: currentVal !== null ? String(currentVal) : void 0,
-		initialValue: currentVal !== null ? String(currentVal) : "",
-		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (!value.trim()) return;
-			const num = Number(value);
-			if (isNaN(num)) return "Please enter a valid number";
-			if (field.integer && !Number.isInteger(num)) return "Please enter a whole number";
-			if (field.min !== void 0 && num < field.min) return `Minimum value is ${field.min}`;
-			if (field.max !== void 0 && num > field.max) return `Maximum value is ${field.max}`;
-		}
-	});
-	if (p.isCancel(result)) return null;
-	if (!result && !field.required) return null;
-	return {
-		op: "set_number",
-		fieldId: field.id,
-		value: result ? Number(result) : null
-	};
-}
-/**
-* Prompt for a string list field value.
-*/
-async function promptForStringList(ctx) {
-	const field = ctx.field;
-	const currentItems = ctx.currentValue?.kind === "string_list" ? ctx.currentValue.items : [];
-	const hint = ctx.description ? `${ctx.description.slice(0, 50)}... (one item per line)` : "Enter items, one per line. Press Enter twice when done.";
-	const result = await p.text({
-		message: formatFieldLabel(ctx),
-		placeholder: hint,
-		initialValue: currentItems.join("\n"),
-		validate: (value) => {
-			const items$1 = value.split("\n").map((s) => s.trim()).filter(Boolean);
-			if (field.required && items$1.length === 0) return "At least one item is required";
-			if (field.minItems && items$1.length < field.minItems) return `Minimum ${field.minItems} items required`;
-			if (field.maxItems && items$1.length > field.maxItems) return `Maximum ${field.maxItems} items allowed`;
-		}
-	});
-	if (p.isCancel(result)) return null;
-	const items = result.split("\n").map((s) => s.trim()).filter(Boolean);
-	if (items.length === 0 && !field.required) return null;
-	return {
-		op: "set_string_list",
-		fieldId: field.id,
-		items
-	};
-}
-/**
-* Prompt for a single-select field value.
-*/
-async function promptForSingleSelect(ctx) {
-	const field = ctx.field;
-	const currentSelected = ctx.currentValue?.kind === "single_select" ? ctx.currentValue.selected : null;
-	const options = field.options.map((opt) => ({
-		value: opt.id,
-		label: opt.label
-	}));
-	const result = await p.select({
-		message: formatFieldLabel(ctx),
-		options,
-		initialValue: currentSelected ?? void 0
-	});
-	if (p.isCancel(result)) return null;
-	return {
-		op: "set_single_select",
-		fieldId: field.id,
-		selected: result
-	};
-}
-/**
-* Prompt for a multi-select field value.
-*/
-async function promptForMultiSelect(ctx) {
-	const field = ctx.field;
-	const currentSelected = ctx.currentValue?.kind === "multi_select" ? ctx.currentValue.selected : [];
-	const options = field.options.map((opt) => ({
-		value: opt.id,
-		label: opt.label
-	}));
-	const result = await p.multiselect({
-		message: formatFieldLabel(ctx),
-		options,
-		initialValues: currentSelected,
-		required: field.required
-	});
-	if (p.isCancel(result)) return null;
-	return {
-		op: "set_multi_select",
-		fieldId: field.id,
-		selected: result
-	};
-}
-/**
-* Prompt for a checkboxes field value.
-*
-* Behavior varies by checkboxMode:
-* - simple: multiselect to pick items marked as done
-* - multi: per-option select with 5 states
-* - explicit: per-option yes/no/skip
-*/
-async function promptForCheckboxes(ctx) {
-	const field = ctx.field;
-	const currentValues = ctx.currentValue?.kind === "checkboxes" ? ctx.currentValue.values : {};
-	if (field.checkboxMode === "simple") {
-		const options = field.options.map((opt) => ({
-			value: opt.id,
-			label: opt.label
-		}));
-		const currentlyDone = field.options.filter((opt) => currentValues[opt.id] === "done").map((opt) => opt.id);
-		const result = await p.multiselect({
-			message: formatFieldLabel(ctx),
-			options,
-			initialValues: currentlyDone,
-			required: field.required && field.minDone !== void 0 && field.minDone > 0
-		});
-		if (p.isCancel(result)) return null;
-		const selected = result;
-		const values$1 = {};
-		for (const opt of field.options) values$1[opt.id] = selected.includes(opt.id) ? "done" : "todo";
-		return {
-			op: "set_checkboxes",
-			fieldId: field.id,
-			values: values$1
-		};
-	}
-	if (field.checkboxMode === "explicit") {
-		const values$1 = {};
-		for (const opt of field.options) {
-			const current = currentValues[opt.id];
-			const result = await p.select({
-				message: `${opt.label}`,
-				options: [
-					{
-						value: "yes",
-						label: "Yes"
-					},
-					{
-						value: "no",
-						label: "No"
-					},
-					{
-						value: "unfilled",
-						label: "Skip"
-					}
-				],
-				initialValue: current === "yes" || current === "no" ? current : "unfilled"
-			});
-			if (p.isCancel(result)) return null;
-			values$1[opt.id] = result;
-		}
-		return {
-			op: "set_checkboxes",
-			fieldId: field.id,
-			values: values$1
-		};
-	}
-	const values = {};
-	for (const opt of field.options) {
-		const current = currentValues[opt.id];
-		const result = await p.select({
-			message: `${opt.label}`,
-			options: [
-				{
-					value: "todo",
-					label: "To do"
-				},
-				{
-					value: "active",
-					label: "In progress"
-				},
-				{
-					value: "done",
-					label: "Done"
-				},
-				{
-					value: "incomplete",
-					label: "Incomplete"
-				},
-				{
-					value: "na",
-					label: "N/A"
-				}
-			],
-			initialValue: current ?? "todo"
-		});
-		if (p.isCancel(result)) return null;
-		values[opt.id] = result;
-	}
-	return {
-		op: "set_checkboxes",
-		fieldId: field.id,
-		values
-	};
-}
-/**
-* Prompt user for a single field value based on field type.
-* Returns a Patch to set the value, or null if skipped/cancelled.
-*/
-async function promptForField(ctx) {
-	if (ctx.description) p.note(ctx.description, pc.dim("Instructions"));
-	switch (ctx.field.kind) {
-		case "string": return promptForString(ctx);
-		case "number": return promptForNumber(ctx);
-		case "string_list": return promptForStringList(ctx);
-		case "single_select": return promptForSingleSelect(ctx);
-		case "multi_select": return promptForMultiSelect(ctx);
-		case "checkboxes": return promptForCheckboxes(ctx);
-		default: return null;
-	}
-}
-/**
-* Run an interactive fill session for a list of field issues.
-* Returns patches for all filled fields.
-*
-* @param form - The parsed form
-* @param issues - The issues indicating fields to fill
-* @returns Array of patches to apply
-*/
-async function runInteractiveFill(form, issues) {
-	const fieldIssues = issues.filter((i) => i.scope === "field");
-	const seenFieldIds = /* @__PURE__ */ new Set();
-	const uniqueFieldIssues = fieldIssues.filter((issue) => {
-		if (seenFieldIds.has(issue.ref)) return false;
-		seenFieldIds.add(issue.ref);
-		return true;
-	});
-	if (uniqueFieldIssues.length === 0) {
-		p.note("No fields to fill for the selected role.", "Info");
-		return {
-			patches: [],
-			cancelled: false
-		};
-	}
-	const patches = [];
-	let index = 0;
-	for (const issue of uniqueFieldIssues) {
-		const field = getFieldById(form, issue.ref);
-		if (!field) continue;
-		index++;
-		const patch = await promptForField({
-			field,
-			currentValue: form.valuesByFieldId[field.id],
-			description: getFieldDescription(form, field.id),
-			index,
-			total: uniqueFieldIssues.length
-		});
-		if (patch === null && p.isCancel(patch)) {
-			const shouldContinue = await p.confirm({
-				message: "Cancel and discard changes?",
-				initialValue: false
-			});
-			if (p.isCancel(shouldContinue) || shouldContinue) return {
-				patches: [],
-				cancelled: true
-			};
-			index--;
-			continue;
-		}
-		if (patch) patches.push(patch);
-	}
-	return {
-		patches,
-		cancelled: false
-	};
-}
-/**
-* Show intro message for interactive fill session.
-*/
-function showInteractiveIntro(formTitle, role, fieldCount) {
-	p.intro(pc.bgCyan(pc.black(" Markform Interactive Fill ")));
-	const lines = [
-		`${pc.bold("Form:")} ${formTitle}`,
-		`${pc.bold("Role:")} ${role}`,
-		`${pc.bold("Fields:")} ${fieldCount} to fill`
-	];
-	p.note(lines.join("\n"), "Session Info");
-}
-/**
-* Show outro message after interactive fill.
-*/
-function showInteractiveOutro(patchCount, outputPath, cancelled) {
-	if (cancelled) {
-		p.cancel("Interactive fill cancelled.");
-		return;
-	}
-	if (patchCount === 0) {
-		p.outro(pc.yellow("No changes made."));
-		return;
-	}
-	p.outro(`✓ ${patchCount} field(s) updated. Saved to ${formatPath(outputPath)}`);
-}
-
-//#endregion
-//#region src/cli/commands/examples.ts
-/**
-* Print non-interactive list of examples.
-*/
-function printExamplesList() {
-	console.log(pc.bold("Available examples:\n"));
-	for (const example of EXAMPLE_DEFINITIONS) {
-		console.log(`  ${pc.cyan(example.id)}`);
-		console.log(`    ${pc.bold(example.title)}`);
-		console.log(`    ${pc.dim(example.description)}`);
-		console.log(`    Default filename: ${example.filename}`);
-		console.log("");
-	}
-}
-/**
-* Display API availability status at startup.
-*/
-function showApiStatus() {
-	console.log(pc.dim("API Status:"));
-	for (const [provider, _models] of Object.entries(SUGGESTED_LLMS)) {
-		const info = getProviderInfo(provider);
-		const hasKey = !!process.env[info.envVar];
-		const status = hasKey ? pc.green("✓") : pc.dim("○");
-		const envVar = hasKey ? pc.dim(info.envVar) : pc.yellow(info.envVar);
-		console.log(`  ${status} ${provider} (${envVar})`);
-	}
-	console.log("");
-}
-/**
-* Build model options for the select prompt.
-*/
-function buildModelOptions() {
-	const options = [];
-	for (const [provider, models] of Object.entries(SUGGESTED_LLMS)) {
-		const info = getProviderInfo(provider);
-		const keyStatus = !!process.env[info.envVar] ? pc.green("✓") : pc.dim("○");
-		for (const model of models.slice(0, 2)) options.push({
-			value: `${provider}/${model}`,
-			label: `${provider}/${model}`,
-			hint: `${keyStatus} ${info.envVar}`
-		});
-	}
-	options.push({
-		value: "custom",
-		label: "Enter custom model ID...",
-		hint: "provider/model-id format"
-	});
-	return options;
-}
-/**
-* Prompt user to select a model for agent fill.
-*/
-async function promptForModel() {
-	const modelOptions = buildModelOptions();
-	const selection = await p.select({
-		message: "Select LLM model:",
-		options: modelOptions
-	});
-	if (p.isCancel(selection)) return null;
-	if (selection === "custom") {
-		const customModel = await p.text({
-			message: "Model ID (provider/model-id):",
-			placeholder: "anthropic/claude-sonnet-4-20250514",
-			validate: (value) => {
-				if (!value.includes("/")) return "Format: provider/model-id (e.g., anthropic/claude-sonnet-4-20250514)";
-			}
-		});
-		if (p.isCancel(customModel)) return null;
-		return customModel;
-	}
-	return selection;
-}
-/**
-* Run the agent fill workflow.
-*/
-async function runAgentFill(form, modelId, _outputPath) {
-	const spinner = p.spinner();
-	try {
-		spinner.start(`Resolving model: ${modelId}`);
-		const { model } = await resolveModel(modelId);
-		spinner.stop(`Model resolved: ${modelId}`);
-		const harnessConfig = {
-			maxTurns: DEFAULT_MAX_TURNS,
-			maxPatchesPerTurn: DEFAULT_MAX_PATCHES_PER_TURN,
-			maxIssues: DEFAULT_MAX_ISSUES,
-			targetRoles: [AGENT_ROLE],
-			fillMode: "continue"
-		};
-		const harness = createHarness(form, harnessConfig);
-		const agent = createLiveAgent({
-			model,
-			targetRole: AGENT_ROLE
-		});
-		console.log("");
-		p.log.step(pc.bold("Agent fill in progress..."));
-		let stepResult = harness.step();
-		while (!stepResult.isComplete && !harness.hasReachedMaxTurns()) {
-			console.log(pc.dim(`  Turn ${stepResult.turnNumber}: ${stepResult.issues.length} issue(s) to address`));
-			const patches = await agent.generatePatches(stepResult.issues, harness.getForm(), harnessConfig.maxPatchesPerTurn);
-			for (const patch of patches) {
-				const fieldId = patch.fieldId;
-				console.log(pc.dim(`    → ${patch.op} ${fieldId}`));
-			}
-			stepResult = harness.apply(patches, stepResult.issues);
-			console.log(pc.dim(`    ${patches.length} patch(es) applied, ${stepResult.issues.length} remaining`));
-			if (!stepResult.isComplete) stepResult = harness.step();
-		}
-		if (stepResult.isComplete) p.log.success(pc.green(`Form completed in ${harness.getTurnNumber()} turn(s)`));
-		else p.log.warn(pc.yellow(`Max turns reached (${harnessConfig.maxTurns})`));
-		Object.assign(form, harness.getForm());
-		return {
-			success: stepResult.isComplete,
-			turnCount: harness.getTurnNumber()
-		};
-	} catch (error) {
-		spinner.stop(pc.red("Agent fill failed"));
-		throw error;
-	}
-}
-/**
-* Run the interactive example scaffolding and filling flow.
-*/
-async function runInteractiveFlow(preselectedId) {
-	const startTime = Date.now();
-	p.intro(pc.bgCyan(pc.black(" markform examples ")));
-	showApiStatus();
-	let selectedId = preselectedId;
-	if (!selectedId) {
-		const selection = await p.select({
-			message: "Select an example form to scaffold:",
-			options: EXAMPLE_DEFINITIONS.map((example$1) => ({
-				value: example$1.id,
-				label: example$1.title,
-				hint: example$1.description
-			}))
-		});
-		if (p.isCancel(selection)) {
-			p.cancel("Cancelled.");
-			process.exit(0);
-		}
-		selectedId = selection;
-	}
-	const example = getExampleById(selectedId);
-	if (!example) {
-		p.cancel(`Unknown example: ${selectedId}`);
-		process.exit(1);
-	}
-	const defaultFilename = generateVersionedPath(example.filename);
-	const filenameResult = await p.text({
-		message: "Output filename:",
-		initialValue: defaultFilename,
-		validate: (value) => {
-			if (!value.trim()) return "Filename is required";
-			if (!value.endsWith(".form.md") && !value.endsWith(".md")) return "Filename should end with .form.md or .md";
-		}
-	});
-	if (p.isCancel(filenameResult)) {
-		p.cancel("Cancelled.");
-		process.exit(0);
-	}
-	const filename = filenameResult;
-	const outputPath = join(process.cwd(), filename);
-	if (existsSync(outputPath)) {
-		const overwrite = await p.confirm({
-			message: `${filename} already exists. Overwrite?`,
-			initialValue: false
-		});
-		if (p.isCancel(overwrite) || !overwrite) {
-			p.cancel("Cancelled.");
-			process.exit(0);
-		}
-	}
-	let content;
-	try {
-		content = loadExampleContent(selectedId);
-		writeFileSync(outputPath, content, "utf-8");
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		p.cancel(`Failed to write file: ${message}`);
-		process.exit(1);
-	}
-	p.log.success(`Created ${formatPath(outputPath)}`);
-	const form = parseForm(content);
-	const targetRoles = [USER_ROLE];
-	const inspectResult = inspect(form, { targetRoles });
-	const fieldIssues = inspectResult.issues.filter((i) => i.scope === "field");
-	const uniqueFieldIds = new Set(fieldIssues.map((i) => i.ref));
-	if (uniqueFieldIds.size === 0) {
-		p.log.info("No user-role fields to fill in this example.");
-		if (inspect(form, { targetRoles: [AGENT_ROLE] }).issues.filter((i) => i.scope === "field").length === 0) {
-			logTiming({
-				verbose: false,
-				format: "console",
-				dryRun: false,
-				quiet: false
-			}, "Total time", Date.now() - startTime);
-			p.outro(pc.dim("Form scaffolded with no fields to fill."));
-			return;
-		}
-	} else {
-		showInteractiveIntro(form.schema.title ?? form.schema.id, targetRoles.join(", "), uniqueFieldIds.size);
-		const { patches, cancelled } = await runInteractiveFill(form, inspectResult.issues);
-		if (cancelled) {
-			showInteractiveOutro(0, "", true);
-			process.exit(1);
-		}
-		if (patches.length > 0) applyPatches(form, patches);
-		const { formPath, rawPath, yamlPath } = exportMultiFormat(form, outputPath);
-		showInteractiveOutro(patches.length, outputPath, false);
-		console.log("");
-		p.log.success("Outputs:");
-		console.log(`  ${formatPath(formPath)}  ${pc.dim("(markform)")}`);
-		console.log(`  ${formatPath(rawPath)}  ${pc.dim("(plain markdown)")}`);
-		console.log(`  ${formatPath(yamlPath)}  ${pc.dim("(values as YAML)")}`);
-		logTiming({
-			verbose: false,
-			format: "console",
-			dryRun: false,
-			quiet: false
-		}, "Fill time", Date.now() - startTime);
-	}
-	const agentFieldIssues = inspect(form, { targetRoles: [AGENT_ROLE] }).issues.filter((i) => i.scope === "field");
-	if (agentFieldIssues.length > 0) {
-		console.log("");
-		p.log.info(`This form has ${agentFieldIssues.length} agent-role field(s) remaining.`);
-		const runAgent = await p.confirm({
-			message: "Run agent fill now?",
-			initialValue: true
-		});
-		if (p.isCancel(runAgent) || !runAgent) {
-			console.log("");
-			console.log(pc.dim("You can run agent fill later with:"));
-			console.log(pc.dim(`  markform fill ${formatPath(outputPath)} --agent=live --model=<provider/model>`));
-			p.outro(pc.dim("Happy form filling!"));
-			return;
-		}
-		const modelId = await promptForModel();
-		if (!modelId) {
-			p.cancel("Cancelled.");
-			process.exit(0);
-		}
-		const agentDefaultFilename = generateVersionedPath(outputPath);
-		const agentFilenameResult = await p.text({
-			message: "Agent output filename:",
-			initialValue: basename(agentDefaultFilename),
-			validate: (value) => {
-				if (!value.trim()) return "Filename is required";
-			}
-		});
-		if (p.isCancel(agentFilenameResult)) {
-			p.cancel("Cancelled.");
-			process.exit(0);
-		}
-		const agentOutputPath = join(process.cwd(), agentFilenameResult);
-		const agentStartTime = Date.now();
-		try {
-			const { success, turnCount: _turnCount } = await runAgentFill(form, modelId, agentOutputPath);
-			logTiming({
-				verbose: false,
-				format: "console",
-				dryRun: false,
-				quiet: false
-			}, "Agent fill time", Date.now() - agentStartTime);
-			const { formPath, rawPath, yamlPath } = exportMultiFormat(form, agentOutputPath);
-			console.log("");
-			p.log.success("Agent fill complete. Outputs:");
-			console.log(`  ${formatPath(formPath)}  ${pc.dim("(markform)")}`);
-			console.log(`  ${formatPath(rawPath)}  ${pc.dim("(plain markdown)")}`);
-			console.log(`  ${formatPath(yamlPath)}  ${pc.dim("(values as YAML)")}`);
-			if (!success) p.log.warn("Agent did not complete all fields. You may need to run it again.");
-		} catch (error) {
-			const message = error instanceof Error ? error.message : String(error);
-			p.log.error(`Agent fill failed: ${message}`);
-			console.log("");
-			console.log(pc.dim("You can try again with:"));
-			console.log(pc.dim(`  markform fill ${formatPath(outputPath)} --agent=live --model=${modelId}`));
-		}
-	}
-	p.outro(pc.dim("Happy form filling!"));
-}
-/**
-* Register the examples command.
-*/
-function registerExamplesCommand(program) {
-	program.command("examples").description("Scaffold an example form and fill it interactively").option("--list", "List available examples without interactive selection").option("--name <example>", "Select example by ID (still prompts for filename)").action(async (options, cmd) => {
-		getCommandContext(cmd);
-		try {
-			if (options.list) {
-				printExamplesList();
-				return;
-			}
-			if (options.name) {
-				if (!getExampleById(options.name)) {
-					logError(`Unknown example: ${options.name}`);
-					console.log("\nAvailable examples:");
-					for (const ex of EXAMPLE_DEFINITIONS) console.log(`  ${ex.id}`);
-					process.exit(1);
-				}
-			}
-			await runInteractiveFlow(options.name);
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/export.ts
-/**
-* Register the export command.
-*/
-function registerExportCommand(program) {
-	program.command("export <file>").description("Export form as markform (default), markdown (readable), or json/yaml for structured data").option("--compact", "Output compact JSON (no formatting, only for JSON format)").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		let format = "markform";
-		if (ctx.format === "json") format = "json";
-		else if (ctx.format === "yaml") format = "yaml";
-		else if (ctx.format === "markdown") format = "markdown";
-		else if (ctx.format === "markform") format = "markform";
-		try {
-			logVerbose(ctx, `Reading file: ${file}`);
-			const content = await readFile(file);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			if (format === "markform") {
-				console.log(serialize(form));
-				return;
-			}
-			if (format === "markdown") {
-				console.log(serializeRawMarkdown(form));
-				return;
-			}
-			const output = {
-				schema: {
-					id: form.schema.id,
-					title: form.schema.title,
-					groups: form.schema.groups.map((group) => ({
-						id: group.id,
-						title: group.title,
-						children: group.children.map((field) => ({
-							id: field.id,
-							kind: field.kind,
-							label: field.label,
-							required: field.required,
-							...field.kind === "single_select" || field.kind === "multi_select" || field.kind === "checkboxes" ? { options: field.options.map((opt) => ({
-								id: opt.id,
-								label: opt.label
-							})) } : {}
-						}))
-					}))
-				},
-				values: form.valuesByFieldId,
-				markdown: serialize(form)
-			};
-			if (format === "json") if (options.compact) console.log(JSON.stringify(output));
-			else console.log(JSON.stringify(output, null, 2));
-			else console.log(YAML.stringify(output));
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/fill.ts
-/** Supported agent types */
-const AGENT_TYPES = ["mock", "live"];
-/**
-* Format a patch value for display.
-*/
-function formatPatchValue(patch) {
-	switch (patch.op) {
-		case "set_string": return patch.value ? `"${patch.value}"` : "(empty)";
-		case "set_number": return patch.value !== null ? String(patch.value) : "(empty)";
-		case "set_string_list": return patch.items.length > 0 ? `[${patch.items.join(", ")}]` : "(empty)";
-		case "set_single_select": return patch.selected ?? "(none)";
-		case "set_multi_select": return patch.selected.length > 0 ? `[${patch.selected.join(", ")}]` : "(none)";
-		case "set_checkboxes": return Object.entries(patch.values).map(([k, v]) => `${k}:${v}`).join(", ");
-		case "clear_field": return "(cleared)";
-	}
-}
-/**
-* Format session transcript for console output.
-*/
-function formatConsoleSession(transcript, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	const dim = useColors ? pc.dim : (s) => s;
-	const cyan = useColors ? pc.cyan : (s) => s;
-	const green = useColors ? pc.green : (s) => s;
-	const yellow = useColors ? pc.yellow : (s) => s;
-	lines.push(bold(cyan("Session Transcript")));
-	lines.push("");
-	lines.push(`${bold("Form:")} ${transcript.form.path}`);
-	lines.push(`${bold("Mode:")} ${transcript.mode}`);
-	lines.push(`${bold("Version:")} ${transcript.sessionVersion}`);
-	lines.push("");
-	lines.push(bold("Harness Config:"));
-	lines.push(`  Max turns: ${transcript.harness.maxTurns}`);
-	lines.push(`  Max patches/turn: ${transcript.harness.maxPatchesPerTurn}`);
-	lines.push(`  Max issues: ${transcript.harness.maxIssues}`);
-	lines.push("");
-	lines.push(bold(`Turns (${transcript.turns.length}):`));
-	for (const turn of transcript.turns) {
-		const issueCount = turn.inspect.issues.length;
-		const patchCount = turn.apply.patches.length;
-		const afterIssues = turn.after.requiredIssueCount;
-		lines.push(`  Turn ${turn.turn}: ${dim(`${issueCount} issues`)} → ${yellow(`${patchCount} patches`)} → ${afterIssues === 0 ? green("0 remaining") : dim(`${afterIssues} remaining`)}`);
-	}
-	lines.push("");
-	const expectText = transcript.final.expectComplete ? green("✓ complete") : yellow("○ incomplete");
-	lines.push(`${bold("Expected:")} ${expectText}`);
-	lines.push(`${bold("Completed form:")} ${transcript.final.expectedCompletedForm}`);
-	return lines.join("\n");
-}
-/**
-* Register the fill command.
-*/
-function registerFillCommand(program) {
-	program.command("fill <file>").description("Run an agent to autonomously fill a form").option("--agent <type>", `Agent type: ${AGENT_TYPES.join(", ")} (default: live)`, "live").option("--model <id>", "Model ID for live agent (format: provider/model-id, e.g. openai/gpt-4o)").option("--mock-source <file>", "Path to completed form for mock agent").option("--record <file>", "Record session transcript to file").option("--max-turns <n>", `Maximum turns (default: ${DEFAULT_MAX_TURNS})`, String(DEFAULT_MAX_TURNS)).option("--max-patches <n>", `Maximum patches per turn (default: ${DEFAULT_MAX_PATCHES_PER_TURN})`, String(DEFAULT_MAX_PATCHES_PER_TURN)).option("--max-issues <n>", `Maximum issues shown per turn (default: ${DEFAULT_MAX_ISSUES})`, String(DEFAULT_MAX_ISSUES)).option("--max-fields <n>", "Maximum unique fields per turn (applied before --max-issues)").option("--max-groups <n>", "Maximum unique groups per turn (applied before --max-issues)").option("--roles <roles>", "Target roles to fill (comma-separated, or '*' for all; default: 'agent' in agent mode, 'user' in --interactive mode)").option("--mode <mode>", "Fill mode: continue (skip filled fields) or overwrite (re-fill; default: continue)").option("-o, --output <file>", "Write final form to file").option("--prompt <file>", "Path to custom system prompt file (appends to default)").option("--instructions <text>", "Inline system prompt (appends to default; takes precedence over --prompt)").option("-i, --interactive", "Interactive mode: prompt user for field values (defaults to user role)").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		const filePath = resolve(file);
-		try {
-			const startTime = Date.now();
-			let targetRoles;
-			if (options.roles) try {
-				targetRoles = parseRolesFlag(options.roles);
-			} catch (error) {
-				logError(`Invalid --roles: ${error instanceof Error ? error.message : String(error)}`);
-				process.exit(1);
-			}
-			else targetRoles = options.interactive ? [USER_ROLE] : [AGENT_ROLE];
-			let fillMode = "continue";
-			if (options.mode) {
-				if (options.mode !== "continue" && options.mode !== "overwrite") {
-					logError(`Invalid --mode: ${options.mode}. Valid modes: continue, overwrite`);
-					process.exit(1);
-				}
-				fillMode = options.mode;
-			}
-			logVerbose(ctx, `Reading form: ${filePath}`);
-			const formContent = await readFile(filePath);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(formContent);
-			if (options.interactive) {
-				if (options.agent && options.agent !== "live") {
-					logError("--interactive cannot be used with --agent");
-					process.exit(1);
-				}
-				if (options.model) {
-					logError("--interactive cannot be used with --model");
-					process.exit(1);
-				}
-				if (options.mockSource) {
-					logError("--interactive cannot be used with --mock-source");
-					process.exit(1);
-				}
-				const inspectResult = inspect(form, { targetRoles });
-				const formTitle = form.schema.title ?? form.schema.id;
-				const fieldIssues = inspectResult.issues.filter((i) => i.scope === "field");
-				const uniqueFieldIds = new Set(fieldIssues.map((i) => i.ref));
-				showInteractiveIntro(formTitle, targetRoles.join(", "), uniqueFieldIds.size);
-				const { patches, cancelled } = await runInteractiveFill(form, inspectResult.issues);
-				if (cancelled) {
-					showInteractiveOutro(0, "", true);
-					process.exit(1);
-				}
-				if (patches.length > 0) applyPatches(form, patches);
-				const durationMs$1 = Date.now() - startTime;
-				const outputPath$1 = options.output ? resolve(options.output) : generateVersionedPath(filePath);
-				const formMarkdown$1 = serialize(form);
-				if (ctx.dryRun) logInfo(ctx, `[DRY RUN] Would write form to: ${outputPath$1}`);
-				else await writeFile(outputPath$1, formMarkdown$1);
-				showInteractiveOutro(patches.length, outputPath$1, false);
-				logTiming(ctx, "Fill time", durationMs$1);
-				if (patches.length > 0) {
-					console.log("");
-					console.log(pc.dim("Next step: fill remaining fields with agent"));
-					console.log(pc.dim(`  markform fill ${outputPath$1} --agent=live --model=<provider/model>`));
-				}
-				process.exit(0);
-			}
-			const agentType = options.agent ?? "live";
-			if (!AGENT_TYPES.includes(agentType)) {
-				logError(`Invalid agent type '${options.agent}'. Valid types: ${AGENT_TYPES.join(", ")}`);
-				process.exit(1);
-			}
-			if (agentType === "mock" && !options.mockSource) {
-				logError("--agent=mock requires --mock-source <file>");
-				process.exit(1);
-			}
-			if (agentType === "live" && !options.model) {
-				logError("--agent=live requires --model <provider/model-id>");
-				console.log("");
-				console.log(formatSuggestedLlms());
-				process.exit(1);
-			}
-			if (targetRoles.includes("*")) logWarn(ctx, "Warning: Filling all roles including user-designated fields");
-			const harnessConfig = {
-				maxTurns: parseInt(options.maxTurns ?? String(DEFAULT_MAX_TURNS), 10),
-				maxPatchesPerTurn: parseInt(options.maxPatches ?? String(DEFAULT_MAX_PATCHES_PER_TURN), 10),
-				maxIssues: parseInt(options.maxIssues ?? String(DEFAULT_MAX_ISSUES), 10),
-				...options.maxFields && { maxFieldsPerTurn: parseInt(options.maxFields, 10) },
-				...options.maxGroups && { maxGroupsPerTurn: parseInt(options.maxGroups, 10) },
-				targetRoles,
-				fillMode
-			};
-			const harness = createHarness(form, harnessConfig);
-			let agent;
-			let mockPath;
-			if (agentType === "mock") {
-				mockPath = resolve(options.mockSource);
-				logVerbose(ctx, `Reading mock source: ${mockPath}`);
-				agent = createMockAgent(parseForm(await readFile(mockPath)));
-			} else {
-				const modelId = options.model;
-				logVerbose(ctx, `Resolving model: ${modelId}`);
-				const { model } = await resolveModel(modelId);
-				let systemPrompt;
-				if (options.instructions) {
-					systemPrompt = options.instructions;
-					logVerbose(ctx, "Using inline system prompt from --instructions");
-				} else if (options.prompt) {
-					const promptPath = resolve(options.prompt);
-					logVerbose(ctx, `Reading system prompt from: ${promptPath}`);
-					systemPrompt = await readFile(promptPath);
-				}
-				const primaryRole = targetRoles[0] === "*" ? AGENT_ROLE : targetRoles[0];
-				agent = createLiveAgent({
-					model,
-					systemPromptAddition: systemPrompt,
-					targetRole: primaryRole
-				});
-				logVerbose(ctx, `Using live agent with model: ${modelId}`);
-			}
-			logInfo(ctx, pc.cyan(`Filling form: ${filePath}`));
-			logInfo(ctx, `Agent: ${agentType}${options.model ? ` (${options.model})` : ""}`);
-			logVerbose(ctx, `Max turns: ${harnessConfig.maxTurns}`);
-			logVerbose(ctx, `Max patches per turn: ${harnessConfig.maxPatchesPerTurn}`);
-			logVerbose(ctx, `Max issues per step: ${harnessConfig.maxIssues}`);
-			logVerbose(ctx, `Target roles: ${targetRoles.includes("*") ? "*" : targetRoles.join(", ")}`);
-			logVerbose(ctx, `Fill mode: ${fillMode}`);
-			let stepResult = harness.step();
-			logInfo(ctx, `Turn ${pc.bold(String(stepResult.turnNumber))}: ${pc.yellow(String(stepResult.issues.length))} issues`);
-			while (!stepResult.isComplete && !harness.hasReachedMaxTurns()) {
-				const patches = await agent.generatePatches(stepResult.issues, harness.getForm(), harnessConfig.maxPatchesPerTurn);
-				logInfo(ctx, `  → ${pc.yellow(String(patches.length))} patches`);
-				for (const patch of patches) {
-					const value = formatPatchValue(patch);
-					logVerbose(ctx, `    ${pc.cyan(patch.fieldId)} ${pc.dim("=")} ${pc.green(value)}`);
-				}
-				stepResult = harness.apply(patches, stepResult.issues);
-				if (stepResult.isComplete) logInfo(ctx, pc.green(`  ✓ Complete`));
-				else {
-					stepResult = harness.step();
-					logInfo(ctx, `Turn ${pc.bold(String(stepResult.turnNumber))}: ${pc.yellow(String(stepResult.issues.length))} issues`);
-				}
-			}
-			const durationMs = Date.now() - startTime;
-			if (stepResult.isComplete) logSuccess(ctx, `Form completed in ${harness.getTurnNumber()} turn(s)`);
-			else if (harness.hasReachedMaxTurns()) logWarn(ctx, `Max turns reached (${harnessConfig.maxTurns})`);
-			logTiming(ctx, "Fill time", durationMs);
-			const outputPath = options.output ? resolve(options.output) : generateVersionedPath(filePath);
-			const formMarkdown = serialize(harness.getForm());
-			if (ctx.dryRun) logInfo(ctx, `[DRY RUN] Would write form to: ${outputPath}`);
-			else {
-				await writeFile(outputPath, formMarkdown);
-				logSuccess(ctx, `Form written to: ${outputPath}`);
-			}
-			const transcript = buildSessionTranscript(filePath, agentType, mockPath, options.model, harnessConfig, harness.getTurns(), stepResult.isComplete, outputPath);
-			if (options.record) {
-				const recordPath = resolve(options.record);
-				const yaml = serializeSession(transcript);
-				if (ctx.dryRun) {
-					logInfo(ctx, `[DRY RUN] Would write session to: ${recordPath}`);
-					console.log(yaml);
-				} else {
-					await writeFile(recordPath, yaml);
-					logSuccess(ctx, `Session recorded to: ${recordPath}`);
-				}
-			} else {
-				const output = formatOutput(ctx, transcript, (data, useColors) => formatConsoleSession(data, useColors));
-				console.log(output);
-			}
-			process.exit(stepResult.isComplete ? 0 : 1);
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-/**
-* Build a session transcript from harness execution.
-*/
-function buildSessionTranscript(formPath, agentType, mockPath, modelId, harnessConfig, turns, expectComplete, outputPath) {
-	const transcript = {
-		sessionVersion: "0.1.0",
-		mode: agentType,
-		form: { path: formPath },
-		harness: harnessConfig,
-		turns,
-		final: {
-			expectComplete,
-			expectedCompletedForm: agentType === "mock" ? mockPath ?? outputPath : outputPath
-		}
-	};
-	if (agentType === "mock" && mockPath) transcript.mock = { completedMock: mockPath };
-	else if (agentType === "live" && modelId) transcript.live = { modelId };
-	return transcript;
-}
-
-//#endregion
-//#region src/cli/commands/inspect.ts
-/**
-* Format state badge for console output.
-*/
-function formatState$1(state, useColors) {
-	const [text, colorFn] = {
-		complete: ["✓ complete", pc.green],
-		incomplete: ["○ incomplete", pc.yellow],
-		empty: ["◌ empty", pc.dim],
-		invalid: ["✗ invalid", pc.red]
-	}[state] ?? [state, (s) => s];
-	return useColors ? colorFn(text) : text;
-}
-/**
-* Format priority badge for console output.
-*
-* Priority tiers and colors:
-* - P1: bold red (critical)
-* - P2: yellow (high)
-* - P3: cyan (medium)
-* - P4: blue (low)
-* - P5: dim/gray (minimal)
-*/
-function formatPriority$1(priority, useColors) {
-	const label = `P${priority}`;
-	if (!useColors) return label;
-	switch (priority) {
-		case 1: return pc.red(pc.bold(label));
-		case 2: return pc.yellow(label);
-		case 3: return pc.cyan(label);
-		case 4: return pc.blue(label);
-		case 5:
-		default: return pc.dim(label);
-	}
-}
-/**
-* Format severity badge for console output.
-*/
-function formatSeverity$1(severity, useColors) {
-	if (!useColors) return severity;
-	return severity === "required" ? pc.red(severity) : pc.yellow(severity);
-}
-/**
-* Format a field value for console display.
-*/
-function formatFieldValue(value, useColors) {
-	const dim = useColors ? pc.dim : (s) => s;
-	const green = useColors ? pc.green : (s) => s;
-	if (!value) return dim("(empty)");
-	switch (value.kind) {
-		case "string": return value.value ? green(`"${value.value}"`) : dim("(empty)");
-		case "number": return value.value !== null ? green(String(value.value)) : dim("(empty)");
-		case "string_list": return value.items.length > 0 ? green(`[${value.items.map((i) => `"${i}"`).join(", ")}]`) : dim("(empty)");
-		case "single_select": return value.selected ? green(value.selected) : dim("(none selected)");
-		case "multi_select": return value.selected.length > 0 ? green(`[${value.selected.join(", ")}]`) : dim("(none selected)");
-		case "checkboxes": {
-			const entries = Object.entries(value.values);
-			if (entries.length === 0) return dim("(no entries)");
-			return entries.map(([k, v]) => `${k}:${v}`).join(", ");
-		}
-		default: return dim("(unknown)");
-	}
-}
-/**
-* Format inspect report for console output.
-*/
-function formatConsoleReport$1(report, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	const dim = useColors ? pc.dim : (s) => s;
-	const cyan = useColors ? pc.cyan : (s) => s;
-	const yellow = useColors ? pc.yellow : (s) => s;
-	lines.push(bold(cyan("Form Inspection Report")));
-	if (report.title) lines.push(`${bold("Title:")} ${report.title}`);
-	lines.push("");
-	lines.push(`${bold("Form State:")} ${formatState$1(report.form_state, useColors)}`);
-	lines.push("");
-	const structure = report.structure;
-	lines.push(bold("Structure:"));
-	lines.push(`  Groups: ${structure.groupCount}`);
-	lines.push(`  Fields: ${structure.fieldCount}`);
-	lines.push(`  Options: ${structure.optionCount}`);
-	lines.push("");
-	const progress = report.progress;
-	lines.push(bold("Progress:"));
-	lines.push(`  Total fields: ${progress.counts.totalFields}`);
-	lines.push(`  Required: ${progress.counts.requiredFields}`);
-	lines.push(`  Submitted: ${progress.counts.submittedFields}`);
-	lines.push(`  Complete: ${progress.counts.completeFields}`);
-	lines.push(`  Incomplete: ${progress.counts.incompleteFields}`);
-	lines.push(`  Invalid: ${progress.counts.invalidFields}`);
-	lines.push(`  Empty (required): ${progress.counts.emptyRequiredFields}`);
-	lines.push(`  Empty (optional): ${progress.counts.emptyOptionalFields}`);
-	lines.push("");
-	lines.push(bold("Form Content:"));
-	for (const group of report.groups) {
-		lines.push(`  ${bold(group.title ?? group.id)}`);
-		for (const field of group.children) {
-			const reqBadge = field.required ? yellow("[required]") : dim("[optional]");
-			const roleBadge = field.role !== "agent" ? cyan(`[${field.role}]`) : "";
-			const value = report.values[field.id];
-			const valueStr = formatFieldValue(value, useColors);
-			lines.push(`    ${field.label} ${dim(`(${field.kind})`)} ${reqBadge} ${roleBadge}`.trim());
-			lines.push(`      ${dim("→")} ${valueStr}`);
-		}
-	}
-	lines.push("");
-	if (report.issues.length > 0) {
-		lines.push(bold(`Issues (${report.issues.length}):`));
-		for (const issue of report.issues) {
-			const priority = formatPriority$1(issue.priority, useColors);
-			const severity = formatSeverity$1(issue.severity, useColors);
-			const blockedInfo = issue.blockedBy ? ` ${dim(`(blocked by: ${issue.blockedBy})`)}` : "";
-			lines.push(`  ${priority} (${severity}) ${dim(`[${issue.scope}]`)} ${dim(issue.ref)}: ${issue.message}${blockedInfo}`);
-		}
-	} else lines.push(dim("No issues found."));
-	return lines.join("\n");
-}
-/**
-* Register the inspect command.
-*/
-function registerInspectCommand(program) {
-	program.command("inspect <file>").description("Inspect a form and display its structure, progress, and issues").option("--roles <roles>", "Filter issues by target roles (comma-separated, or '*' for all; default: all)").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		try {
-			let targetRoles;
-			if (options.roles) try {
-				targetRoles = parseRolesFlag(options.roles);
-				if (targetRoles.includes("*")) targetRoles = void 0;
-			} catch (error) {
-				logError(`Invalid --roles: ${error instanceof Error ? error.message : String(error)}`);
-				process.exit(1);
-			}
-			logVerbose(ctx, `Reading file: ${file}`);
-			const content = await readFile(file);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			logVerbose(ctx, "Running inspection...");
-			const result = inspect(form, { targetRoles });
-			const output = formatOutput(ctx, {
-				title: form.schema.title,
-				structure: result.structureSummary,
-				progress: result.progressSummary,
-				form_state: result.formState,
-				groups: form.schema.groups.map((group) => ({
-					id: group.id,
-					title: group.title,
-					children: group.children.map((field) => ({
-						id: field.id,
-						kind: field.kind,
-						label: field.label,
-						required: field.required,
-						role: field.role
-					}))
-				})),
-				values: form.valuesByFieldId,
-				issues: result.issues.map((issue) => ({
-					ref: issue.ref,
-					scope: issue.scope,
-					reason: issue.reason,
-					message: issue.message,
-					priority: issue.priority,
-					severity: issue.severity,
-					blockedBy: issue.blockedBy
-				}))
-			}, (data, useColors) => formatConsoleReport$1(data, useColors));
-			console.log(output);
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/models.ts
-/**
-* Get model info for all providers or a specific one.
-*/
-function getModelInfo(providerFilter) {
-	const providers = getProviderNames();
-	if (providerFilter && !providers.includes(providerFilter)) throw new Error(`Unknown provider: "${providerFilter}". Available: ${providers.join(", ")}`);
-	return (providerFilter ? [providerFilter] : providers).map((provider) => {
-		return {
-			provider,
-			envVar: getProviderInfo(provider).envVar,
-			models: SUGGESTED_LLMS[provider] ?? []
-		};
-	});
-}
-/**
-* Format model info for console output.
-*/
-function formatConsoleOutput(info, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	const cyan = useColors ? pc.cyan : (s) => s;
-	const dim = useColors ? pc.dim : (s) => s;
-	const green = useColors ? pc.green : (s) => s;
-	for (const { provider, envVar, models } of info) {
-		lines.push(bold(cyan(`${provider}/`)));
-		lines.push(`  ${dim("env:")} ${envVar}`);
-		if (models.length > 0) {
-			lines.push(`  ${dim("models:")}`);
-			for (const model of models) lines.push(`    ${green(`${provider}/${model}`)}`);
-		} else lines.push(`  ${dim("(no suggested models)")}`);
-		lines.push("");
-	}
-	if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-	return lines.join("\n");
-}
-/**
-* Register the models command.
-*/
-function registerModelsCommand(program) {
-	program.command("models").description("List available AI providers and example models").option("-p, --provider <name>", "Filter by provider (anthropic, openai, google, xai, deepseek)").action((options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		try {
-			const output = formatOutput(ctx, getModelInfo(options.provider), (data, useColors) => formatConsoleOutput(data, useColors));
-			console.log(output);
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/serve.ts
-/**
-* Open a URL in the default browser (cross-platform).
-*/
-function openBrowser(url) {
-	const platform = process.platform;
-	let command;
-	if (platform === "darwin") command = `open "${url}"`;
-	else if (platform === "win32") command = `start "" "${url}"`;
-	else command = `xdg-open "${url}"`;
-	exec(command, (error) => {
-		if (error) {}
-	});
-}
-/**
-* Register the serve command.
-*/
-function registerServeCommand(program) {
-	program.command("serve <file>").description("Serve a form as a web page for browsing").option("-p, --port <port>", "Port to serve on", String(DEFAULT_PORT)).option("--no-open", "Don't open browser automatically").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		const port = parseInt(options.port ?? String(DEFAULT_PORT), 10);
-		const filePath = resolve(file);
-		try {
-			logVerbose(ctx, `Reading file: ${filePath}`);
-			let form = parseForm(await readFile(filePath));
-			const server = createServer((req, res) => {
-				handleRequest(req, res, form, filePath, ctx, (updatedForm) => {
-					form = updatedForm;
-				}).catch((err) => {
-					console.error("Request error:", err);
-					res.writeHead(500);
-					res.end("Internal Server Error");
-				});
-			});
-			server.listen(port, () => {
-				const url = `http://localhost:${port}`;
-				logInfo(ctx, pc.green(`\n✓ Form server running at ${pc.bold(url)}\n`));
-				logInfo(ctx, pc.dim("Press Ctrl+C to stop\n"));
-				if (options.open !== false) openBrowser(url);
-			});
-			process.on("SIGINT", () => {
-				logInfo(ctx, "\nShutting down server...");
-				server.close();
-				process.exit(0);
-			});
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-/**
-* Handle HTTP requests.
-*/
-async function handleRequest(req, res, form, filePath, ctx, updateForm) {
-	const url = req.url ?? "/";
-	if (req.method === "GET" && url === "/") {
-		const html = renderFormHtml(form);
-		res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
-		res.end(html);
-	} else if (req.method === "POST" && url === "/save") await handleSave(req, res, form, filePath, ctx, updateForm);
-	else if (url === "/api/form") {
-		res.writeHead(200, { "Content-Type": "application/json" });
-		res.end(JSON.stringify({ schema: form.schema }));
-	} else {
-		res.writeHead(404);
-		res.end("Not Found");
-	}
-}
-/**
-* Parse form body data.
-*/
-function parseFormBody(body) {
-	const result = {};
-	const params = new URLSearchParams(body);
-	for (const [key, value] of params) {
-		const existing = result[key];
-		if (existing !== void 0) if (Array.isArray(existing)) existing.push(value);
-		else result[key] = [existing, value];
-		else result[key] = value;
-	}
-	return result;
-}
-/**
-* Convert form data to patches.
-*/
-function formDataToPatches(formData, form) {
-	const patches = [];
-	const fields = form.schema.groups.flatMap((g) => g.children);
-	for (const field of fields) {
-		const fieldId = field.id;
-		switch (field.kind) {
-			case "string": {
-				const value = formData[fieldId];
-				if (typeof value === "string" && value.trim() !== "") patches.push({
-					op: "set_string",
-					fieldId,
-					value: value.trim()
-				});
-				else if (!value || typeof value === "string" && value.trim() === "") patches.push({
-					op: "clear_field",
-					fieldId
-				});
-				break;
-			}
-			case "number": {
-				const value = formData[fieldId];
-				if (typeof value === "string" && value.trim() !== "") {
-					const num = parseFloat(value);
-					if (!isNaN(num)) patches.push({
-						op: "set_number",
-						fieldId,
-						value: num
-					});
-				} else patches.push({
-					op: "clear_field",
-					fieldId
-				});
-				break;
-			}
-			case "string_list": {
-				const value = formData[fieldId];
-				if (typeof value === "string" && value.trim() !== "") {
-					const items = value.split("\n").map((s) => s.trim()).filter((s) => s !== "");
-					if (items.length > 0) patches.push({
-						op: "set_string_list",
-						fieldId,
-						items
-					});
-					else patches.push({
-						op: "clear_field",
-						fieldId
-					});
-				} else patches.push({
-					op: "clear_field",
-					fieldId
-				});
-				break;
-			}
-			case "single_select": {
-				const value = formData[fieldId];
-				if (typeof value === "string" && value !== "") patches.push({
-					op: "set_single_select",
-					fieldId,
-					selected: value
-				});
-				else patches.push({
-					op: "clear_field",
-					fieldId
-				});
-				break;
-			}
-			case "multi_select": {
-				const value = formData[fieldId];
-				const selected = Array.isArray(value) ? value : value ? [value] : [];
-				if (selected.length > 0 && selected[0] !== "") patches.push({
-					op: "set_multi_select",
-					fieldId,
-					selected
-				});
-				else patches.push({
-					op: "clear_field",
-					fieldId
-				});
-				break;
-			}
-			case "checkboxes":
-				if ((field.checkboxMode ?? "multi") === "simple") {
-					const value = formData[fieldId];
-					const checked = Array.isArray(value) ? value : value ? [value] : [];
-					const values = {};
-					for (const opt of field.options) values[opt.id] = checked.includes(opt.id) ? "done" : "todo";
-					patches.push({
-						op: "set_checkboxes",
-						fieldId,
-						values
-					});
-				} else {
-					const values = {};
-					for (const opt of field.options) {
-						const selectValue = formData[`${fieldId}.${opt.id}`];
-						if (typeof selectValue === "string" && selectValue !== "") values[opt.id] = selectValue;
-					}
-					if (Object.keys(values).length > 0) patches.push({
-						op: "set_checkboxes",
-						fieldId,
-						values
-					});
-				}
-				break;
-		}
-	}
-	return patches;
-}
-/**
-* Handle form save request.
-*/
-async function handleSave(req, res, form, filePath, ctx, updateForm) {
-	try {
-		const chunks = [];
-		for await (const chunk of req) chunks.push(chunk);
-		applyPatches(form, formDataToPatches(parseFormBody(Buffer.concat(chunks).toString("utf-8")), form));
-		updateForm(form);
-		const newPath = generateVersionedPath(filePath);
-		const content = serialize(form);
-		if (ctx.dryRun) {
-			logInfo(ctx, `[DRY RUN] Would save to: ${newPath}`);
-			res.writeHead(200, { "Content-Type": "application/json" });
-			res.end(JSON.stringify({
-				success: true,
-				path: newPath,
-				dryRun: true
-			}));
-			return;
-		}
-		await writeFile(newPath, content);
-		logInfo(ctx, pc.green(`Saved to: ${newPath}`));
-		res.writeHead(200, { "Content-Type": "application/json" });
-		res.end(JSON.stringify({
-			success: true,
-			path: newPath
-		}));
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		res.writeHead(500, { "Content-Type": "application/json" });
-		res.end(JSON.stringify({
-			success: false,
-			error: message
-		}));
-	}
-}
-/**
-* Render the form as HTML.
-* @public Exported for testing.
-*/
-function renderFormHtml(form) {
-	const { schema, valuesByFieldId } = form;
-	const formTitle = schema.title ?? schema.id;
-	const groupsHtml = schema.groups.map((group) => renderGroup(group, valuesByFieldId)).join("\n");
-	return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(formTitle)} - Markform</title>
-  <style>
-    * { box-sizing: border-box; }
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      line-height: 1.6;
-      max-width: 800px;
-      margin: 0 auto;
-      padding: 2rem;
-      background: #f8f9fa;
-      color: #212529;
-    }
-    h1 { color: #495057; border-bottom: 2px solid #dee2e6; padding-bottom: 0.5rem; }
-    h2 { color: #6c757d; margin-top: 2rem; font-size: 1.25rem; }
-    .group {
-      background: white;
-      border-radius: 8px;
-      padding: 1.5rem;
-      margin-bottom: 1.5rem;
-      box-shadow: 0 1px 3px rgba(0,0,0,0.1);
-    }
-    .field {
-      margin-bottom: 1.5rem;
-      padding-bottom: 1rem;
-      border-bottom: 1px solid #e9ecef;
-    }
-    .field:last-child { border-bottom: none; margin-bottom: 0; padding-bottom: 0; }
-    .field-label {
-      font-weight: 600;
-      color: #495057;
-      display: block;
-      margin-bottom: 0.5rem;
-    }
-    .required { color: #dc3545; }
-    .type-badge {
-      font-size: 0.7rem;
-      padding: 0.1rem 0.3rem;
-      background: #e9ecef;
-      border-radius: 3px;
-      color: #6c757d;
-      margin-left: 0.5rem;
-      font-weight: normal;
-    }
-    input[type="text"],
-    input[type="number"],
-    textarea,
-    select {
-      width: 100%;
-      padding: 0.5rem 0.75rem;
-      font-size: 1rem;
-      border: 1px solid #ced4da;
-      border-radius: 4px;
-      background: #fff;
-      transition: border-color 0.15s ease-in-out;
-    }
-    input[type="text"]:focus,
-    input[type="number"]:focus,
-    textarea:focus,
-    select:focus {
-      outline: none;
-      border-color: #80bdff;
-      box-shadow: 0 0 0 0.2rem rgba(0,123,255,.25);
-    }
-    textarea {
-      min-height: 100px;
-      resize: vertical;
-    }
-    .checkbox-group {
-      display: flex;
-      flex-direction: column;
-      gap: 0.5rem;
-    }
-    .checkbox-item {
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-    }
-    .checkbox-item input[type="checkbox"] {
-      width: auto;
-      margin: 0;
-    }
-    .checkbox-item label {
-      margin: 0;
-      font-weight: normal;
-      cursor: pointer;
-    }
-    .checkbox-item select {
-      width: auto;
-      min-width: 120px;
-    }
-    .option-row {
-      display: flex;
-      align-items: center;
-      gap: 0.75rem;
-      margin-bottom: 0.5rem;
-    }
-    .option-row:last-child { margin-bottom: 0; }
-    .option-label {
-      flex: 1;
-    }
-    .toolbar {
-      position: fixed;
-      bottom: 2rem;
-      right: 2rem;
-      display: flex;
-      gap: 0.5rem;
-    }
-    .btn {
-      padding: 0.75rem 1.5rem;
-      border: none;
-      border-radius: 6px;
-      font-size: 1rem;
-      cursor: pointer;
-      transition: all 0.2s;
-    }
-    .btn-primary {
-      background: #0d6efd;
-      color: white;
-    }
-    .btn-primary:hover { background: #0b5ed7; }
-    .field-help {
-      font-size: 0.85rem;
-      color: #6c757d;
-      margin-top: 0.25rem;
-    }
-  </style>
-</head>
-<body>
-  <h1>${escapeHtml(formTitle)}</h1>
-  <form method="POST" action="/save" id="markform">
-    ${groupsHtml}
-    <div class="toolbar">
-      <button type="submit" class="btn btn-primary">Save</button>
-    </div>
-  </form>
-  <script>
-    document.getElementById('markform').addEventListener('submit', async (e) => {
-      e.preventDefault();
-      const formData = new FormData(e.target);
-      const params = new URLSearchParams();
-      for (const [key, value] of formData) {
-        params.append(key, value);
-      }
-      try {
-        const res = await fetch('/save', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-          body: params.toString()
-        });
-        const data = await res.json();
-        if (data.success) {
-          alert('Saved to: ' + data.path);
-          location.reload();
-        } else {
-          alert('Error: ' + data.error);
-        }
-      } catch (err) {
-        alert('Save failed: ' + err.message);
-      }
-    });
-  <\/script>
-</body>
-</html>`;
-}
-/**
-* Render a field group as HTML.
-*/
-function renderGroup(group, values) {
-	const groupTitle = group.title ?? group.id;
-	const fieldsHtml = group.children.map((field) => renderFieldHtml(field, values[field.id])).join("\n");
-	return `
-  <div class="group">
-    <h2>${escapeHtml(groupTitle)}</h2>
-    ${fieldsHtml}
-  </div>`;
-}
-/**
-* Render a field as HTML.
-* @public Exported for testing.
-*/
-function renderFieldHtml(field, value) {
-	const requiredMark = field.required ? "<span class=\"required\">*</span>" : "";
-	const typeLabel = `<span class="type-badge">${field.kind}</span>`;
-	let inputHtml;
-	switch (field.kind) {
-		case "string":
-			inputHtml = renderStringInput(field, value);
-			break;
-		case "number":
-			inputHtml = renderNumberInput(field, value);
-			break;
-		case "string_list":
-			inputHtml = renderStringListInput(field, value);
-			break;
-		case "single_select":
-			inputHtml = renderSingleSelectInput(field, value);
-			break;
-		case "multi_select":
-			inputHtml = renderMultiSelectInput(field, value);
-			break;
-		case "checkboxes":
-			inputHtml = renderCheckboxesInput(field, value);
-			break;
-		default: inputHtml = "<div class=\"field-help\">(unknown field type)</div>";
-	}
-	return `
-    <div class="field">
-      <label class="field-label" for="field-${field.id}">
-        ${escapeHtml(field.label)} ${requiredMark} ${typeLabel}
-      </label>
-      ${inputHtml}
-    </div>`;
-}
-/**
-* Render a string field as text input.
-*/
-function renderStringInput(field, value) {
-	const currentValue = value?.kind === "string" && value.value !== null ? value.value : "";
-	const requiredAttr = field.required ? " required" : "";
-	const minLengthAttr = field.minLength !== void 0 ? ` minlength="${field.minLength}"` : "";
-	const maxLengthAttr = field.maxLength !== void 0 ? ` maxlength="${field.maxLength}"` : "";
-	return `<input type="text" id="field-${field.id}" name="${field.id}" value="${escapeHtml(currentValue)}"${requiredAttr}${minLengthAttr}${maxLengthAttr}>`;
-}
-/**
-* Render a number field as number input.
-*/
-function renderNumberInput(field, value) {
-	const currentValue = value?.kind === "number" && value.value !== null ? String(value.value) : "";
-	const requiredAttr = field.required ? " required" : "";
-	const minAttr = field.min !== void 0 ? ` min="${field.min}"` : "";
-	const maxAttr = field.max !== void 0 ? ` max="${field.max}"` : "";
-	const stepAttr = field.integer ? " step=\"1\"" : "";
-	return `<input type="number" id="field-${field.id}" name="${field.id}" value="${escapeHtml(currentValue)}"${requiredAttr}${minAttr}${maxAttr}${stepAttr}>`;
-}
-/**
-* Render a string list field as textarea.
-*/
-function renderStringListInput(field, value) {
-	const currentValue = (value?.kind === "string_list" ? value.items : []).join("\n");
-	const requiredAttr = field.required ? " required" : "";
-	return `<textarea id="field-${field.id}" name="${field.id}" placeholder="Enter one item per line"${requiredAttr}>${escapeHtml(currentValue)}</textarea>`;
-}
-/**
-* Render a single-select field as select element.
-*/
-function renderSingleSelectInput(field, value) {
-	const selected = value?.selected ?? null;
-	const requiredAttr = field.required ? " required" : "";
-	const options = field.options.map((opt) => {
-		const selectedAttr = selected === opt.id ? " selected" : "";
-		return `<option value="${escapeHtml(opt.id)}"${selectedAttr}>${escapeHtml(opt.label)}</option>`;
-	}).join("\n      ");
-	return `<select id="field-${field.id}" name="${field.id}"${requiredAttr}>
-      <option value="">-- Select --</option>
-      ${options}
-    </select>`;
-}
-/**
-* Render a multi-select field as checkboxes.
-*/
-function renderMultiSelectInput(field, value) {
-	const selected = value?.selected ?? [];
-	return `<div class="checkbox-group">
-      ${field.options.map((opt) => {
-		const checkedAttr = selected.includes(opt.id) ? " checked" : "";
-		const checkboxId = `field-${field.id}-${opt.id}`;
-		return `<div class="checkbox-item">
-        <input type="checkbox" id="${checkboxId}" name="${field.id}" value="${escapeHtml(opt.id)}"${checkedAttr}>
-        <label for="${checkboxId}">${escapeHtml(opt.label)}</label>
-      </div>`;
-	}).join("\n      ")}
-    </div>`;
-}
-/**
-* Render checkboxes field based on mode.
-*/
-function renderCheckboxesInput(field, value) {
-	const checkboxValues = value?.values ?? {};
-	const mode = field.checkboxMode ?? "multi";
-	if (mode === "simple") return `<div class="checkbox-group">
-      ${field.options.map((opt) => {
-		const checkedAttr = checkboxValues[opt.id] === "done" ? " checked" : "";
-		const checkboxId = `field-${field.id}-${opt.id}`;
-		return `<div class="checkbox-item">
-        <input type="checkbox" id="${checkboxId}" name="${field.id}" value="${escapeHtml(opt.id)}"${checkedAttr}>
-        <label for="${checkboxId}">${escapeHtml(opt.label)}</label>
-      </div>`;
-	}).join("\n      ")}
-    </div>`;
-	if (mode === "explicit") return `<div class="checkbox-group">
-      ${field.options.map((opt) => {
-		const state = checkboxValues[opt.id] ?? "unfilled";
-		const selectId = `field-${field.id}-${opt.id}`;
-		const selectName = `${field.id}.${opt.id}`;
-		return `<div class="option-row">
-        <span class="option-label">${escapeHtml(opt.label)}</span>
-        <select id="${selectId}" name="${selectName}">
-          <option value="unfilled"${state === "unfilled" ? " selected" : ""}>-- Select --</option>
-          <option value="yes"${state === "yes" ? " selected" : ""}>Yes</option>
-          <option value="no"${state === "no" ? " selected" : ""}>No</option>
-        </select>
-      </div>`;
-	}).join("\n      ")}
-    </div>`;
-	return `<div class="checkbox-group">
-      ${field.options.map((opt) => {
-		const state = checkboxValues[opt.id] ?? "todo";
-		const selectId = `field-${field.id}-${opt.id}`;
-		const selectName = `${field.id}.${opt.id}`;
-		return `<div class="option-row">
-        <span class="option-label">${escapeHtml(opt.label)}</span>
-        <select id="${selectId}" name="${selectName}">
-          <option value="todo"${state === "todo" ? " selected" : ""}>To Do</option>
-          <option value="active"${state === "active" ? " selected" : ""}>Active</option>
-          <option value="done"${state === "done" ? " selected" : ""}>Done</option>
-          <option value="incomplete"${state === "incomplete" ? " selected" : ""}>Incomplete</option>
-          <option value="na"${state === "na" ? " selected" : ""}>N/A</option>
-        </select>
-      </div>`;
-	}).join("\n      ")}
-    </div>`;
-}
-/**
-* Escape HTML special characters.
-* @public Exported for testing.
-*/
-function escapeHtml(str) {
-	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
-}
-
-//#endregion
-//#region src/cli/commands/render.ts
-/**
-* Generate default output path by replacing .form.md with .form.html.
-*/
-function getDefaultOutputPath(inputPath) {
-	const dir = dirname(inputPath);
-	const base = basename(inputPath);
-	const newBase = base.replace(/\.form\.md$/i, ".form.html");
-	if (newBase === base) return `${inputPath}.html`;
-	return resolve(dir, newBase);
-}
-/**
-* Register the render command.
-*/
-function registerRenderCommand(program) {
-	program.command("render <file>").description("Render a form as static HTML output").option("-o, --output <path>", "Output file path (default: same stem + .html)").action(async (file, options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		const filePath = resolve(file);
-		const outputPath = options.output ? resolve(options.output) : getDefaultOutputPath(filePath);
-		try {
-			logVerbose(ctx, `Reading file: ${filePath}`);
-			const content = await readFile(filePath);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			logVerbose(ctx, "Rendering HTML...");
-			const html = renderFormHtml(form);
-			if (ctx.dryRun) {
-				logDryRun(`Would write HTML to: ${outputPath}`);
-				return;
-			}
-			await writeFile(outputPath, html);
-			logSuccess(ctx, pc.green(`✓ Rendered to ${outputPath}`));
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/commands/validate.ts
-/**
-* Format state badge for console output.
-*/
-function formatState(state, useColors) {
-	const [text, colorFn] = {
-		complete: ["✓ complete", pc.green],
-		incomplete: ["○ incomplete", pc.yellow],
-		empty: ["◌ empty", pc.dim],
-		invalid: ["✗ invalid", pc.red]
-	}[state] ?? [state, (s) => s];
-	return useColors ? colorFn(text) : text;
-}
-/**
-* Format priority badge for console output.
-*/
-function formatPriority(priority, useColors) {
-	const label = `P${priority}`;
-	if (!useColors) return label;
-	switch (priority) {
-		case 1: return pc.red(pc.bold(label));
-		case 2: return pc.yellow(label);
-		case 3: return pc.cyan(label);
-		case 4: return pc.blue(label);
-		case 5:
-		default: return pc.dim(label);
-	}
-}
-/**
-* Format severity badge for console output.
-*/
-function formatSeverity(severity, useColors) {
-	if (!useColors) return severity;
-	return severity === "required" ? pc.red(severity) : pc.yellow(severity);
-}
-/**
-* Format validate report for console output.
-*/
-function formatConsoleReport(report, useColors) {
-	const lines = [];
-	const bold = useColors ? pc.bold : (s) => s;
-	const dim = useColors ? pc.dim : (s) => s;
-	const cyan = useColors ? pc.cyan : (s) => s;
-	lines.push(bold(cyan("Form Validation Report")));
-	if (report.title) lines.push(`${bold("Title:")} ${report.title}`);
-	lines.push("");
-	lines.push(`${bold("Form State:")} ${formatState(report.form_state, useColors)}`);
-	lines.push("");
-	const structure = report.structure;
-	lines.push(bold("Structure:"));
-	lines.push(`  Groups: ${structure.groupCount}`);
-	lines.push(`  Fields: ${structure.fieldCount}`);
-	lines.push(`  Options: ${structure.optionCount}`);
-	lines.push("");
-	const progress = report.progress;
-	lines.push(bold("Progress:"));
-	lines.push(`  Total fields: ${progress.counts.totalFields}`);
-	lines.push(`  Required: ${progress.counts.requiredFields}`);
-	lines.push(`  Submitted: ${progress.counts.submittedFields}`);
-	lines.push(`  Complete: ${progress.counts.completeFields}`);
-	lines.push(`  Incomplete: ${progress.counts.incompleteFields}`);
-	lines.push(`  Invalid: ${progress.counts.invalidFields}`);
-	lines.push(`  Empty (required): ${progress.counts.emptyRequiredFields}`);
-	lines.push(`  Empty (optional): ${progress.counts.emptyOptionalFields}`);
-	lines.push("");
-	if (report.issues.length > 0) {
-		lines.push(bold(`Issues (${report.issues.length}):`));
-		for (const issue of report.issues) {
-			const priority = formatPriority(issue.priority, useColors);
-			const severity = formatSeverity(issue.severity, useColors);
-			lines.push(`  ${priority} (${severity}) ${dim(`[${issue.scope}]`)} ${dim(issue.ref)}: ${issue.message}`);
-		}
-	} else lines.push(dim("No issues found."));
-	return lines.join("\n");
-}
-/**
-* Register the validate command.
-*/
-function registerValidateCommand(program) {
-	program.command("validate <file>").description("Validate a form and display summary and issues (no form content)").action(async (file, _options, cmd) => {
-		const ctx = getCommandContext(cmd);
-		try {
-			logVerbose(ctx, `Reading file: ${file}`);
-			const content = await readFile(file);
-			logVerbose(ctx, "Parsing form...");
-			const form = parseForm(content);
-			logVerbose(ctx, "Running validation...");
-			const result = inspect(form);
-			const output = formatOutput(ctx, {
-				title: form.schema.title,
-				structure: result.structureSummary,
-				progress: result.progressSummary,
-				form_state: result.formState,
-				issues: result.issues.map((issue) => ({
-					ref: issue.ref,
-					scope: issue.scope,
-					reason: issue.reason,
-					message: issue.message,
-					priority: issue.priority,
-					severity: issue.severity
-				}))
-			}, (data, useColors) => formatConsoleReport(data, useColors));
-			console.log(output);
-		} catch (error) {
-			logError(error instanceof Error ? error.message : String(error));
-			process.exit(1);
-		}
-	});
-}
-
-//#endregion
-//#region src/cli/cli.ts
-/**
-* CLI implementation for markform.
-*
-* Provides commands for inspecting, applying patches, exporting,
-* serving, and running harness loops on .form.md files.
-*/
-/**
-* Configure Commander with colored help text and global options display.
-*/
-function withColoredHelp(cmd) {
-	cmd.configureHelp({
-		styleTitle: (str) => pc.bold(pc.cyan(str)),
-		styleCommandText: (str) => pc.green(str),
-		styleOptionText: (str) => pc.yellow(str),
-		showGlobalOptions: true
-	});
-	return cmd;
-}
-/**
-* Create and configure the CLI program.
-*/
-function createProgram() {
-	const program = withColoredHelp(new Command());
-	program.name("markform").description("Agent-friendly, human-readable, editable forms").version(VERSION).option("--verbose", "Enable verbose output").option("--quiet", "Suppress non-essential output").option("--dry-run", "Show what would be done without making changes").option("--format <format>", `Output format: ${OUTPUT_FORMATS.join(", ")}`, "console");
-	registerInspectCommand(program);
-	registerValidateCommand(program);
-	registerApplyCommand(program);
-	registerExportCommand(program);
-	registerDumpCommand(program);
-	registerRenderCommand(program);
-	registerServeCommand(program);
-	registerFillCommand(program);
-	registerModelsCommand(program);
-	registerExamplesCommand(program);
-	return program;
-}
-/**
-* Run the CLI.
-*/
-async function runCli() {
-	await createProgram().parseAsync(process.argv);
-}
-
-//#endregion
-export { runCli as t };