markform 0.1.17 → 0.1.19

package/dist/{cli-DAl8LQzI.mjs → cli-tpvFNqFY.mjs}

@@ -1,16 +1,16 @@
 
-import { L as PatchSchema } from "./coreTypes-DiCddBKu.mjs";
-import { A as MAX_FORMS_IN_MENU, B as formatSuggestedLlms, C as DEFAULT_MAX_TURNS, D as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN, E as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, F as deriveSchemaPath, H as hasWebSearchSupport, I as detectFileType, L as parseRolesFlag, M as USER_ROLE, N as deriveExportPath, P as deriveReportPath, R as SUGGESTED_LLMS, U as parseModelIdForDisplay, _ as validateSyntaxConsistency, b as DEFAULT_MAX_ISSUES_PER_TURN, d as serializeForm, f as serializeRawMarkdown, i as inspect, j as REPORT_EXTENSION, m as friendlyUrlAbbrev, n as getAllFields, p as serializeReport, t as applyPatches, v as AGENT_ROLE, w as DEFAULT_PORT, x as DEFAULT_MAX_PATCHES_PER_TURN, y as DEFAULT_FORMS_DIR, z as WEB_SEARCH_CONFIG } from "./apply-DgDJBscb.mjs";
-import { D as parseForm, E as formToJsonSchema, a as resolveHarnessConfig, c as getProviderNames, d as createLiveAgent, h as createHarness, i as runResearch, l as resolveModel, n as isResearchForm, o as fillForm, p as createMockAgent, s as getProviderInfo, t as VERSION, u as buildMockWireFormat } from "./src-CHVJLGKt.mjs";
-import { n as serializeSession } from "./session-XDrocA3j.mjs";
-import { _ as writeFile, a as formatPath, c as logError, d as logTiming, f as logVerbose, g as stripHtmlComments, h as shouldUseColors, i as formatOutput, l as logInfo, m as readFile$1, n as createSpinner, o as getCommandContext, p as logWarn, r as ensureFormsDir, s as logDryRun, t as OUTPUT_FORMATS, u as logSuccess } from "./shared-CCq4haEV.mjs";
+import { L as PatchSchema } from "./coreTypes-CPKXf2dc.mjs";
+import { $ as WEB_SEARCH_CONFIG, B as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, F as DEFAULT_MAX_PATCHES_PER_TURN, G as REPORT_EXTENSION, J as deriveReportPath, K as USER_ROLE, L as DEFAULT_MAX_TURNS, M as DEFAULT_FORMS_DIR, N as DEFAULT_MAX_ISSUES_PER_TURN, Q as SUGGESTED_LLMS, R as DEFAULT_PORT, V as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN, W as MAX_FORMS_IN_MENU, X as detectFileType, Y as deriveSchemaPath, Z as parseRolesFlag, c as computeProgressSummary, d as serializeForm, et as formatSuggestedLlms, f as serializeRawMarkdown, h as friendlyUrlAbbrev, i as inspect, j as AGENT_ROLE, l as computeStructureSummary, m as formatBareUrlsAsHtmlLinks, n as getAllFields, nt as hasWebSearchSupport, p as serializeReport, q as deriveExportPath, rt as parseModelIdForDisplay, t as applyPatches, v as validateSyntaxConsistency } from "./apply-Dalpt-D6.mjs";
+import { C as resolveModel, D as computeExecutionPlan, E as FillRecordCollector, H as formToJsonSchema, S as getProviderNames, T as createLiveAgent, U as parseForm, _ as fillForm, g as resolveHarnessConfig, h as formatFillRecordSummary, i as runResearch, j as createHarness, k as createMockAgent, m as stripUnstableFillRecordFields, n as isResearchForm, t as VERSION, w as buildMockWireFormat, x as getProviderInfo } from "./src-BTyz-wS6.mjs";
+import { n as serializeSession } from "./session-CK0x28RO.mjs";
+import { _ as writeFile, a as formatPath, c as logError, d as logTiming, f as logVerbose, g as stripHtmlComments, h as shouldUseColors, i as formatOutput, l as logInfo, m as readFile$1, n as createSpinner, o as getCommandContext, p as logWarn, r as ensureFormsDir, s as logDryRun, t as OUTPUT_FORMATS, u as logSuccess } from "./shared-DwdyWmvE.mjs";
 import Markdoc from "@markdoc/markdoc";
 import YAML from "yaml";
 import { Command } from "commander";
 import pc from "picocolors";
 import { exec, execSync, spawn } from "node:child_process";
 import { basename, dirname, join, resolve } from "node:path";
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { readFile } from "node:fs/promises";
 import * as p from "@clack/prompts";
@@ -253,12 +253,12 @@ function registerApplyCommand(program) {
 			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"}`);
+				const result = PatchSchema.safeParse(patches[i]);
+				if (!result.success) {
+					logError(`Invalid patch at index ${i}: ${result.error.issues[0]?.message ?? "Unknown error"}`);
 					process.exit(1);
 				}
-				validatedPatches.push(result$1.data);
+				validatedPatches.push(result.data);
 			}
 			if (ctx.dryRun) {
 				logDryRun(`Would apply ${validatedPatches.length} patches to ${file}`, { patches: validatedPatches });
@@ -418,7 +418,7 @@ async function displayWithPager(content, title) {
 		return;
 	}
 	const header = `${pc.bgCyan(pc.black(` ${title} `))}`;
-	return new Promise((resolve$1) => {
+	return new Promise((resolve) => {
 		const pager = spawn("less", [
 			"-R",
 			"-S",
@@ -435,10 +435,10 @@ async function displayWithPager(content, title) {
 			console.log("");
 			console.log(content);
 			console.log("");
-			resolve$1();
+			resolve();
 		});
 		pager.on("close", () => {
-			resolve$1();
+			resolve();
 		});
 		pager.stdin.write(header + "\n\n");
 		pager.stdin.write(content);
@@ -1353,13 +1353,13 @@ function parseVersionedPath(filePath) {
 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}`;
+		let candidate = `${filePath}-filled1`;
+		let version = 1;
+		while (existsSync(candidate)) {
+			version++;
+			candidate = `${filePath}-filled${version}`;
 		}
-		return candidate$1;
+		return candidate;
 	}
 	let version = parsed.version !== null ? parsed.version + 1 : 1;
 	let candidate = `${parsed.base}-filled${version}${parsed.extension}`;
@@ -1469,10 +1469,10 @@ async function promptForString(ctx) {
 		placeholder: placeholderText,
 		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 (field.required && !value?.trim()) return "This field is required";
+			if (field.minLength && (value?.length ?? 0) < field.minLength) return `Minimum ${field.minLength} characters required`;
+			if (field.maxLength && (value?.length ?? 0) > field.maxLength) return `Maximum ${field.maxLength} characters allowed`;
+			if (field.pattern && value && !new RegExp(field.pattern).test(value)) return `Must match pattern: ${field.pattern}`;
 		}
 	});
 	if (p.isCancel(result)) return null;
@@ -1480,7 +1480,7 @@ async function promptForString(ctx) {
 	return {
 		op: "set_string",
 		fieldId: field.id,
-		value: result || null
+		value: result ?? null
 	};
 }
 /**
@@ -1495,8 +1495,8 @@ async function promptForNumber(ctx) {
 		placeholder: placeholderText,
 		initialValue: currentVal !== null ? String(currentVal) : "",
 		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (!value.trim()) return;
+			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";
@@ -1527,14 +1527,14 @@ async function promptForStringList(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`;
+			const items = (value ?? "").split("\n").map((s) => s.trim()).filter(Boolean);
+			if (field.required && items.length === 0) return "At least one item is required";
+			if (field.minItems && items.length < field.minItems) return `Minimum ${field.minItems} items required`;
+			if (field.maxItems && items.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);
+	const items = (result ?? "").split("\n").map((s) => s.trim()).filter(Boolean);
 	if (items.length === 0 && !field.required) return null;
 	return {
 		op: "set_string_list",
@@ -1612,16 +1612,16 @@ async function promptForCheckboxes(ctx) {
 		});
 		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";
+		const values = {};
+		for (const opt of field.options) values[opt.id] = selected.includes(opt.id) ? "done" : "todo";
 		return {
 			op: "set_checkboxes",
 			fieldId: field.id,
-			value: values$1
+			value: values
 		};
 	}
 	if (field.checkboxMode === "explicit") {
-		const values$1 = {};
+		const values = {};
 		for (const opt of field.options) {
 			const current = currentValues[opt.id];
 			const result = await p.select({
@@ -1643,12 +1643,12 @@ async function promptForCheckboxes(ctx) {
 				initialValue: current === "yes" || current === "no" ? current : "unfilled"
 			});
 			if (p.isCancel(result)) return null;
-			values$1[opt.id] = result;
+			values[opt.id] = result;
 		}
 		return {
 			op: "set_checkboxes",
 			fieldId: field.id,
-			value: values$1
+			value: values
 		};
 	}
 	const values = {};
@@ -1701,8 +1701,8 @@ async function promptForUrl(ctx) {
 		placeholder: placeholderText,
 		initialValue: currentVal ?? "",
 		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (!value.trim()) return;
+			if (field.required && !value?.trim()) return "This field is required";
+			if (!value?.trim()) return;
 			try {
 				new URL(value);
 			} catch {
@@ -1715,7 +1715,7 @@ async function promptForUrl(ctx) {
 	return {
 		op: "set_url",
 		fieldId: field.id,
-		value: result || null
+		value: result ?? null
 	};
 }
 /**
@@ -1743,8 +1743,8 @@ async function promptForDate(ctx) {
 		placeholder: currentVal ?? `YYYY-MM-DD${formatHint}`,
 		initialValue: currentVal ?? "",
 		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (!value.trim()) return;
+			if (field.required && !value?.trim()) return "This field is required";
+			if (!value?.trim()) return;
 			if (!isValidDate(value)) return "Please enter a valid date in YYYY-MM-DD format";
 			if (field.min && value < field.min) return `Date must be on or after ${field.min}`;
 			if (field.max && value > field.max) return `Date must be on or before ${field.max}`;
@@ -1755,7 +1755,7 @@ async function promptForDate(ctx) {
 	return {
 		op: "set_date",
 		fieldId: field.id,
-		value: result || null
+		value: result ?? null
 	};
 }
 /** Default year range for validation */
@@ -1774,8 +1774,8 @@ async function promptForYear(ctx) {
 		placeholder: currentVal !== null ? String(currentVal) : `Year (${minYear}-${maxYear})`,
 		initialValue: currentVal !== null ? String(currentVal) : "",
 		validate: (value) => {
-			if (field.required && !value.trim()) return "This field is required";
-			if (!value.trim()) return;
+			if (field.required && !value?.trim()) return "This field is required";
+			if (!value?.trim()) return;
 			const num = Number(value);
 			if (isNaN(num) || !Number.isInteger(num)) return "Please enter a valid year (e.g., 2025)";
 			if (num < minYear) return `Year must be ${minYear} or later`;
@@ -1805,11 +1805,11 @@ async function promptForUrlList(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 URL is required";
-			if (field.minItems && items$1.length < field.minItems) return `Minimum ${field.minItems} URLs required`;
-			if (field.maxItems && items$1.length > field.maxItems) return `Maximum ${field.maxItems} URLs allowed`;
-			for (const item of items$1) try {
+			const items = (value ?? "").split("\n").map((s) => s.trim()).filter(Boolean);
+			if (field.required && items.length === 0) return "At least one URL is required";
+			if (field.minItems && items.length < field.minItems) return `Minimum ${field.minItems} URLs required`;
+			if (field.maxItems && items.length > field.maxItems) return `Maximum ${field.maxItems} URLs allowed`;
+			for (const item of items) try {
 				new URL(item);
 			} catch {
 				return `Invalid URL: ${item}`;
@@ -1817,7 +1817,7 @@ async function promptForUrlList(ctx) {
 		}
 	});
 	if (p.isCancel(result)) return null;
-	const items = result.split("\n").map((s) => s.trim()).filter(Boolean);
+	const items = (result ?? "").split("\n").map((s) => s.trim()).filter(Boolean);
 	if (items.length === 0 && !field.required) return null;
 	return {
 		op: "set_url_list",
@@ -2188,7 +2188,7 @@ async function promptForModel(webSearchRequired) {
 			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 (!value?.includes("/")) return "Format: provider/model-id (e.g., anthropic/claude-sonnet-4-20250514)";
 			}
 		});
 		if (p.isCancel(customModel)) return null;
@@ -2278,6 +2278,7 @@ async function runAgentFillWorkflow(form, modelId, formsDir, filePath, isResearc
 		fillMode: overwrite ? "overwrite" : "continue",
 		enableWebSearch: isResearch,
 		captureWireFormat: false,
+		recordFill: false,
 		callbacks
 	});
 	if (result.status.ok) p.log.success(pc.green(`Form completed in ${result.turns} turn(s)`));
@@ -2768,7 +2769,7 @@ function formatConsoleSession(transcript, useColors) {
 * Register the fill command.
 */
 function registerFillCommand(program) {
-	program.command("fill <file>").description("Run an agent to autonomously fill a form").option("--mock", "Use mock agent (requires --mock-source)").option("--model <id>", "Model ID for live agent (format: provider/model-id, e.g. openai/gpt-5-mini)").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_PER_TURN})`, String(DEFAULT_MAX_ISSUES_PER_TURN)).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', or '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)").option("--normalize", "Regenerate form without preserving external content").action(async (file, options, cmd) => {
+	program.command("fill <file>").description("Run an agent to autonomously fill a form").option("--mock", "Use mock agent (requires --mock-source)").option("--model <id>", "Model ID for live agent (format: provider/model-id, e.g. openai/gpt-5-mini)").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_PER_TURN})`, String(DEFAULT_MAX_ISSUES_PER_TURN)).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', or '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)").option("--normalize", "Regenerate form without preserving external content").option("--record-fill", "Write fill record to sidecar .fill.json file").option("--record-fill-stable", "Write fill record without timestamps/durations (for golden tests)").action(async (file, options, cmd) => {
 		const ctx = getCommandContext(cmd);
 		const filePath = resolve(file);
 		try {
@@ -2817,19 +2818,19 @@ function registerFillCommand(program) {
 					process.exit(1);
 				}
 				if (patches.length > 0) applyPatches(form, patches);
-				const durationMs$1 = Date.now() - startTime;
-				let outputPath$1;
-				if (options.output) outputPath$1 = resolve(options.output);
+				const durationMs = Date.now() - startTime;
+				let outputPath;
+				if (options.output) outputPath = resolve(options.output);
 				else {
 					const formsDir = getFormsDir(ctx.formsDir);
 					await ensureFormsDir(formsDir);
-					outputPath$1 = generateVersionedPathInFormsDir(filePath, formsDir);
+					outputPath = generateVersionedPathInFormsDir(filePath, formsDir);
 				}
 				if (ctx.dryRun) {
-					logInfo(ctx, `[DRY RUN] Would write form to: ${outputPath$1}`);
+					logInfo(ctx, `[DRY RUN] Would write form to: ${outputPath}`);
 					showInteractiveOutro(patches.length, false);
 				} else {
-					const { reportPath, yamlPath, formPath, schemaPath } = await exportMultiFormat(form, outputPath$1);
+					const { reportPath, yamlPath, formPath, schemaPath } = await exportMultiFormat(form, outputPath);
 					showInteractiveOutro(patches.length, false);
 					console.log("");
 					p.log.success("Outputs:");
@@ -2838,11 +2839,11 @@ function registerFillCommand(program) {
 					console.log(`  ${formatPath(formPath)}  ${pc.dim("(filled markform source)")}`);
 					console.log(`  ${formatPath(schemaPath)}  ${pc.dim("(JSON Schema)")}`);
 				}
-				logTiming(ctx, "Fill time", durationMs$1);
+				logTiming(ctx, "Fill time", durationMs);
 				if (patches.length > 0) {
 					console.log("");
 					console.log("Next step: fill remaining fields with agent");
-					console.log(`  markform fill ${formatPath(outputPath$1)} --model=<provider/model>`);
+					console.log(`  markform fill ${formatPath(outputPath)} --model=<provider/model>`);
 				}
 				process.exit(0);
 			}
@@ -2867,6 +2868,7 @@ function registerFillCommand(program) {
 				fillMode
 			});
 			const harness = createHarness(form, harnessConfig);
+			let collector;
 			let agent;
 			let mockPath;
 			let agentProvider;
@@ -2877,12 +2879,36 @@ function registerFillCommand(program) {
 				mockPath = resolve(options.mockSource);
 				logVerbose(ctx, `Reading mock source: ${mockPath}`);
 				agent = createMockAgent(parseForm(await readFile$1(mockPath)));
+				const structureSummary = computeStructureSummary(form.schema);
+				collector = new FillRecordCollector({
+					form: {
+						id: form.schema.id,
+						title: form.schema.title,
+						description: form.schema.description,
+						structure: structureSummary
+					},
+					provider: "mock",
+					model: "mock",
+					parallelEnabled: false
+				});
 			} else {
 				const modelIdString = options.model;
 				logVerbose(ctx, `Resolving model: ${modelIdString}`);
 				const { model, provider, modelId } = await resolveModel(modelIdString);
 				agentProvider = provider;
 				agentModelName = modelId;
+				const structureSummary = computeStructureSummary(form.schema);
+				collector = new FillRecordCollector({
+					form: {
+						id: form.schema.id,
+						title: form.schema.title,
+						description: form.schema.description,
+						structure: structureSummary
+					},
+					provider,
+					model: modelIdString,
+					parallelEnabled: false
+				});
 				let systemPrompt;
 				if (options.instructions) {
 					systemPrompt = options.instructions;
@@ -2892,13 +2918,30 @@ function registerFillCommand(program) {
 					logVerbose(ctx, `Reading system prompt from: ${promptPath}`);
 					systemPrompt = await readFile$1(promptPath);
 				}
-				const callbacks = createCliToolCallbacks({
+				const cliCallbacks = createCliToolCallbacks({
 					message: (msg) => currentSpinner?.message(msg),
 					update: (context) => currentSpinner?.update(context),
 					stop: (msg) => currentSpinner?.stop(msg),
 					error: (msg) => currentSpinner?.error(msg),
 					getElapsedMs: () => currentSpinner?.getElapsedMs() ?? 0
 				}, ctx);
+				const liveCollector = collector;
+				const callbacks = {
+					onToolStart: (call) => {
+						cliCallbacks.onToolStart?.(call);
+						liveCollector.onToolStart(call);
+					},
+					onToolEnd: (call) => {
+						cliCallbacks.onToolEnd?.(call);
+						liveCollector.onToolEnd(call);
+					},
+					onLlmCallStart: (call) => {
+						liveCollector.onLlmCallStart(call);
+					},
+					onLlmCallEnd: (call) => {
+						liveCollector.onLlmCallEnd(call);
+					}
+				};
 				targetRole = targetRoles[0] === "*" ? AGENT_ROLE : targetRoles[0] ?? AGENT_ROLE;
 				const liveAgent = createLiveAgent({
 					model,
@@ -3012,6 +3055,24 @@ function registerFillCommand(program) {
 				await writeFile(outputPath, formMarkdown);
 				logSuccess(ctx, `Form written to: ${outputPath}`);
 			}
+			const finalInspect = inspect(harness.getForm(), { targetRoles });
+			const progressSummary = computeProgressSummary(form.schema, harness.getForm().responsesByFieldId, harness.getForm().notes, finalInspect.issues);
+			collector.setStatus(stepResult.isComplete ? "completed" : "partial", stepResult.isComplete ? void 0 : "max_turns");
+			const fillRecord = collector.getRecord(progressSummary.counts);
+			if (!ctx.quiet) {
+				console.log("");
+				const summary = formatFillRecordSummary(fillRecord, { verbose: ctx.verbose });
+				console.error(summary);
+			}
+			if (options.recordFill || options.recordFillStable) {
+				const sidecarPath = outputPath.replace(/\.(form\.)?md$/, ".fill.json");
+				const recordToWrite = options.recordFillStable ? stripUnstableFillRecordFields(fillRecord) : fillRecord;
+				if (ctx.dryRun) logInfo(ctx, `[DRY RUN] Would write fill record to: ${sidecarPath}`);
+				else {
+					writeFileSync(sidecarPath, JSON.stringify(recordToWrite, null, 2));
+					logSuccess(ctx, `Fill record written to: ${sidecarPath}`);
+				}
+			}
 			const transcript = buildSessionTranscript(filePath, options.mock ? "mock" : "live", mockPath, options.model, harnessConfig, harness.getTurns(), stepResult.isComplete, outputPath);
 			if (options.record) {
 				const recordPath = resolve(options.record);
@@ -3098,7 +3159,6 @@ function formatPriority$1(priority, useColors) {
 		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);
 	}
 }
@@ -3535,6 +3595,191 @@ function registerModelsCommand(program) {
 	});
 }
 
+//#endregion
+//#region src/cli/commands/plan.ts
+/**
+* Get the response status string for a field.
+*/
+function getFieldStatus(form, fieldId) {
+	const response = form.responsesByFieldId[fieldId];
+	if (!response) return "unanswered";
+	return response.state;
+}
+/**
+* Check if a field still needs work (not yet answered).
+*/
+function fieldNeedsWork(form, fieldId) {
+	const response = form.responsesByFieldId[fieldId];
+	if (!response) return true;
+	return response.state !== "answered";
+}
+/**
+* Get all field IDs for an execution plan item.
+*/
+function getFieldIdsForItem(form, item) {
+	if (item.itemType === "field") return [item.itemId];
+	const group = form.schema.groups.find((g) => g.id === item.itemId);
+	if (!group) return [];
+	return group.children.map((f) => f.id);
+}
+/**
+* Get field metadata from the form schema.
+*/
+function getFieldMeta(form, fieldId) {
+	for (const group of form.schema.groups) {
+		const field = group.children.find((f) => f.id === fieldId);
+		if (field) return field;
+	}
+}
+/**
+* Build a PlanItemJson, including only fields that need work.
+* Returns undefined if no fields need work.
+*/
+function buildPlanItem(form, item) {
+	const remainingFieldIds = getFieldIdsForItem(form, item).filter((id) => fieldNeedsWork(form, id));
+	if (remainingFieldIds.length === 0) return;
+	const planItem = {
+		itemId: item.itemId,
+		itemType: item.itemType
+	};
+	if (item.itemType === "group") planItem.fields = remainingFieldIds.map((id) => {
+		const meta = getFieldMeta(form, id);
+		return {
+			fieldId: id,
+			label: meta?.label,
+			status: getFieldStatus(form, id),
+			required: meta?.required ?? false
+		};
+	});
+	return planItem;
+}
+function formatConsolePlan(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;
+	const titlePart = report.title ? ` (${report.title})` : "";
+	lines.push(bold(cyan(`Plan: ${report.formId}${titlePart}`)));
+	lines.push("");
+	if (report.orderLevels.length === 0) {
+		lines.push(dim("No remaining work — all fields are complete."));
+		return lines.join("\n");
+	}
+	for (const level of report.orderLevels) {
+		const itemCount = level.looseSerial.length + level.parallelBatches.reduce((sum, b) => sum + b.items.length, 0);
+		lines.push(bold(`Order level ${level.order} (${itemCount} items):`));
+		if (level.looseSerial.length > 0) {
+			lines.push(`  Loose serial (primary agent):`);
+			for (const item of level.looseSerial) formatItem(lines, item, dim, yellow, "    ");
+		}
+		for (const batch of level.parallelBatches) {
+			lines.push(`  Parallel batch "${batch.batchId}" (${batch.items.length} items, ${batch.items.length} agents):`);
+			for (const item of batch.items) formatItem(lines, item, dim, yellow, "    ");
+		}
+		lines.push("");
+	}
+	const s = report.summary;
+	lines.push(dim(`Summary: ${s.orderLevelCount} order level${s.orderLevelCount !== 1 ? "s" : ""}, ${s.parallelBatchCount} parallel batch${s.parallelBatchCount !== 1 ? "es" : ""}, ${s.remainingFields} remaining field${s.remainingFields !== 1 ? "s" : ""}`));
+	return lines.join("\n");
+}
+function formatItem(lines, item, dim, yellow, indent) {
+	if (item.itemType === "group" && item.fields) {
+		lines.push(`${indent}- ${item.itemId} [group]`);
+		for (const f of item.fields) {
+			const label = f.label ? ` (${f.label})` : "";
+			const req = f.required ? yellow("required") + ", " : "";
+			lines.push(`${indent}    ${f.fieldId}${label} — ${req}${dim(f.status)}`);
+		}
+	} else {
+		const meta = item;
+		lines.push(`${indent}- ${meta.itemId}`);
+	}
+}
+/**
+* Register the plan command.
+*/
+function registerPlanCommand(program) {
+	program.command("plan <file>").description("Show the idealized execution plan for a form (parallel batches, order levels)").action(async (file, _options, cmd) => {
+		const ctx = getCommandContext(cmd);
+		try {
+			logVerbose(ctx, `Reading file: ${file}`);
+			const content = await readFile$1(file);
+			logVerbose(ctx, "Parsing and validating form...");
+			const form = parseForm(content);
+			const parseErrors = inspect(form).issues.filter((i) => i.reason === "validation_error");
+			if (parseErrors.length > 0) {
+				logError(`Form has validation errors. Fix them before planning:\n` + parseErrors.map((e) => `  - ${e.message}`).join("\n"));
+				process.exit(1);
+			}
+			logVerbose(ctx, "Computing execution plan...");
+			const executionPlan = computeExecutionPlan(form);
+			const orderLevels = [];
+			let totalItems = 0;
+			let totalRemainingFields = 0;
+			let totalBatches = 0;
+			for (const order of executionPlan.orderLevels) {
+				const looseItems = [];
+				for (const item of executionPlan.looseSerial) {
+					if (item.order !== order) continue;
+					const planItem = buildPlanItem(form, item);
+					if (planItem) {
+						looseItems.push(planItem);
+						totalItems++;
+						totalRemainingFields += countRemainingFields(form, item);
+					}
+				}
+				const batches = [];
+				for (const batch of executionPlan.parallelBatches) {
+					const batchItems = [];
+					for (const item of batch.items) {
+						if (item.order !== order) continue;
+						const planItem = buildPlanItem(form, item);
+						if (planItem) {
+							batchItems.push(planItem);
+							totalItems++;
+							totalRemainingFields += countRemainingFields(form, item);
+						}
+					}
+					if (batchItems.length > 0) {
+						batches.push({
+							batchId: batch.batchId,
+							items: batchItems
+						});
+						totalBatches++;
+					}
+				}
+				if (looseItems.length > 0 || batches.length > 0) orderLevels.push({
+					order,
+					looseSerial: looseItems,
+					parallelBatches: batches
+				});
+			}
+			const output = formatOutput(ctx, {
+				formId: form.schema.id,
+				title: form.schema.title,
+				orderLevels,
+				summary: {
+					orderLevelCount: orderLevels.length,
+					parallelBatchCount: totalBatches,
+					totalItems,
+					remainingFields: totalRemainingFields
+				}
+			}, (data, useColors) => formatConsolePlan(data, useColors));
+			console.log(output);
+		} catch (error) {
+			logError(error instanceof Error ? error.message : String(error));
+			process.exit(1);
+		}
+	});
+}
+/**
+* Count remaining fields for an execution plan item.
+*/
+function countRemainingFields(form, item) {
+	return getFieldIdsForItem(form, item).filter((id) => fieldNeedsWork(form, id)).length;
+}
+
 //#endregion
 //#region src/cli/commands/serve.ts
 /**
@@ -5130,7 +5375,7 @@ function renderViewFieldValue(field, value, isSkipped) {
 		case "string": {
 			const v = value.kind === "string" ? value.value : null;
 			if (v === null || v === "") return "<div class=\"view-field-empty\">(not filled)</div>";
-			return `<div class="view-field-value">${escapeHtml(v)}</div>`;
+			return `<div class="view-field-value">${formatBareUrlsAsHtmlLinks(v, escapeHtml)}</div>`;
 		}
 		case "number": {
 			const v = value.kind === "number" ? value.value : null;
@@ -5140,7 +5385,7 @@ function renderViewFieldValue(field, value, isSkipped) {
 		case "string_list": {
 			const items = value.kind === "string_list" ? value.items : [];
 			if (items.length === 0) return "<div class=\"view-field-empty\">(not filled)</div>";
-			return `<div class="view-field-value"><ul>${items.map((i) => `<li>${escapeHtml(i)}</li>`).join("")}</ul></div>`;
+			return `<div class="view-field-value"><ul>${items.map((i) => `<li>${formatBareUrlsAsHtmlLinks(i, escapeHtml)}</li>`).join("")}</ul></div>`;
 		}
 		case "single_select": {
 			const selected = value.kind === "single_select" ? value.selected : null;
@@ -5204,7 +5449,7 @@ function renderViewFieldValue(field, value, isSkipped) {
 						if (col.type === "url" && cellValue) {
 							const domain = friendlyUrlAbbrev(cellValue);
 							cellHtml = `<a href="${escapeHtml(cellValue)}" target="_blank" class="url-link" data-url="${escapeHtml(cellValue)}">${escapeHtml(domain)}</a>`;
-						} else cellHtml = escapeHtml(cellValue);
+						} else cellHtml = formatBareUrlsAsHtmlLinks(cellValue, escapeHtml);
 					}
 					tableHtml += `<td>${cellHtml}</td>`;
 				}
@@ -5415,6 +5660,7 @@ function renderMarkdownContent(content) {
 }
 /**
 * Format inline markdown (bold, italic, code, links, checkboxes).
+* Also auto-links bare URLs for consistency.
 */
 function formatInlineMarkdown(text) {
 	let result = escapeHtml(text);
@@ -5427,6 +5673,12 @@ function formatInlineMarkdown(text) {
 		const cleanUrl = url.replace(/&amp;/g, "&");
 		return `<a href="${cleanUrl}" target="_blank" class="url-link" data-url="${cleanUrl}">${linkText}</a>`;
 	});
+	result = result.replace(/(?<!href="|data-url="|">|\]\()(?:https?:\/\/|www\.)[^\s<>"]+(?<![.,;:!?'")])/g, (url) => {
+		const cleanUrl = url.replace(/&amp;/g, "&");
+		const fullUrl = cleanUrl.startsWith("www.") ? `https://${cleanUrl}` : cleanUrl;
+		const display = friendlyUrlAbbrev(fullUrl);
+		return `<a href="${escapeHtml(fullUrl)}" target="_blank" class="url-link" data-url="${escapeHtml(fullUrl)}">${escapeHtml(display)}</a>`;
+	});
 	return result;
 }
 /**
@@ -5594,7 +5846,7 @@ function registerResearchCommand(program) {
 			const modelId = options.model;
 			const { provider, model: modelName } = parseModelIdForDisplay(modelId);
 			if (!hasWebSearchSupport(provider)) {
-				const webSearchProviders = Object.entries(WEB_SEARCH_CONFIG).filter(([, config]) => config.supported).map(([p$1]) => p$1);
+				const webSearchProviders = Object.entries(WEB_SEARCH_CONFIG).filter(([, config]) => config.supported).map(([p]) => p);
 				logError(`Model "${modelId}" does not support web search.`);
 				console.log("");
 				console.log(pc.yellow("Research forms require web search capabilities."));
@@ -5642,6 +5894,7 @@ function registerResearchCommand(program) {
 					model: modelId,
 					enableWebSearch: true,
 					captureWireFormat: false,
+					recordFill: false,
 					maxTurnsTotal: maxTurns,
 					maxPatchesPerTurn,
 					maxIssuesPerTurn,
@@ -5664,10 +5917,10 @@ function registerResearchCommand(program) {
 			console.log(`  ${formPath}  ${pc.dim("(filled markform source)")}`);
 			console.log(`  ${schemaPath}  ${pc.dim("(JSON Schema)")}`);
 			if (options.transcript && result.transcript) {
-				const { serializeSession: serializeSession$1 } = await import("./session-B7aR6hno.mjs");
+				const { serializeSession } = await import("./session-ZHBi3LVQ.mjs");
 				const transcriptPath = outputPath.replace(/\.form\.md$/, ".session.yaml");
-				const { writeFile: writeFile$1 } = await import("./shared-fUKfJ1UA.mjs");
-				await writeFile$1(transcriptPath, serializeSession$1(result.transcript));
+				const { writeFile } = await import("./shared-BTR35aMz.mjs");
+				await writeFile(transcriptPath, serializeSession(result.transcript));
 				logInfo(ctx, `Transcript: ${transcriptPath}`);
 			}
 			logTiming(ctx, "Research fill", Date.now() - startTime);
@@ -5742,7 +5995,6 @@ function computeFieldStats(form, fields) {
 		case "aborted":
 			aborted++;
 			break;
-		case "unanswered":
 		default:
 			unanswered++;
 			break;
@@ -5909,7 +6161,6 @@ function formatPriority(priority, useColors) {
 		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);
 	}
 }
@@ -6053,6 +6304,7 @@ function createProgram() {
 	registerFillCommand(program);
 	registerInspectCommand(program);
 	registerModelsCommand(program);
+	registerPlanCommand(program);
 	registerRenderCommand(program);
 	registerReportCommand(program);
 	registerResearchCommand(program);
@@ -6072,4 +6324,4 @@ async function runCli() {
 
 //#endregion
 export { runCli as t };
-//# sourceMappingURL=cli-DAl8LQzI.mjs.map
+//# sourceMappingURL=cli-tpvFNqFY.mjs.map