cdx-chores 0.0.8 → 0.0.9-canary.2

package/dist/cjs/index.cjs

@@ -974,6 +974,14 @@ function normalizeOptionalPositiveInteger(value, context) {
 		exitCode: 2
 	});
 }
+function normalizeOptionalBoolean(value, context) {
+	if (value === void 0 || value === null || value === "") return;
+	if (typeof value === "boolean") return value;
+	throw new CliError(`Invalid header mapping artifact: ${context} must be a boolean.`, {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
+}
 function throwUnsupportedHeaderMappingVersion(version, options = {}) {
 	const suffix = options.rewriting ? " Cannot preserve it safely while rewriting." : "";
 	throw new CliError(`Unsupported header mapping artifact version: ${String(version)}.${suffix}`, {
@@ -993,6 +1001,7 @@ function createHeaderMappingInputReference(options) {
 		...options.shape?.bodyStartRow !== void 0 ? { bodyStartRow: options.shape.bodyStartRow } : {},
 		format: options.format,
 		...options.shape?.headerRow !== void 0 ? { headerRow: options.shape.headerRow } : {},
+		...options.shape?.noHeader ? { noHeader: true } : {},
 		path: normalizedRelativePath,
 		...options.shape?.range ? { range: options.shape.range } : {},
 		...options.shape?.source ? { source: options.shape.source } : {}
@@ -1206,10 +1215,12 @@ function parseDataHeaderMappingArtifact(parsed, options = {}) {
 	};
 	const bodyStartRow = normalizeOptionalPositiveInteger(input.bodyStartRow, "input.bodyStartRow");
 	const headerRow = normalizeOptionalPositiveInteger(input.headerRow, "input.headerRow");
+	const noHeader = normalizeOptionalBoolean(input.noHeader, "input.noHeader");
 	const source = normalizeOptionalString(input.source);
 	const range = normalizeOptionalString(input.range);
 	if (bodyStartRow !== void 0) normalizedInput.bodyStartRow = bodyStartRow;
 	if (headerRow !== void 0) normalizedInput.headerRow = headerRow;
+	if (noHeader) normalizedInput.noHeader = true;
 	if (source) normalizedInput.source = source;
 	if (range) normalizedInput.range = range;
 	if (!Array.isArray(parsed.mappings)) throw new CliError("Invalid header mapping artifact: mappings must be an array.", {
@@ -1317,7 +1328,7 @@ async function writeDataHeaderMappingArtifact(path, artifact, options = {}) {
 function resolveReusableHeaderMappings(options) {
 	const expected = options.currentInput;
 	const actual = options.artifact.input;
-	if (!(actual.bodyStartRow === expected.bodyStartRow && actual.path === expected.path && actual.format === expected.format && actual.headerRow === expected.headerRow && actual.source === expected.source && actual.range === expected.range)) throw new CliError("Header mapping artifact does not match the current input context exactly.", {
+	if (!(actual.bodyStartRow === expected.bodyStartRow && actual.path === expected.path && actual.format === expected.format && actual.headerRow === expected.headerRow && actual.noHeader === expected.noHeader && actual.source === expected.source && actual.range === expected.range)) throw new CliError("Header mapping artifact does not match the current input context exactly.", {
 		code: "INVALID_INPUT",
 		exitCode: 2
 	});
@@ -1340,8 +1351,9 @@ function isGeneratedQueryPlaceholderSequence(names) {
 		return Number.isInteger(detectedIndex) && detectedIndex === index;
 	});
 }
-async function shouldNormalizeGeneratedQueryColumnNames(connection, inputPath, format, columnNames) {
+async function shouldNormalizeGeneratedQueryColumnNames(connection, inputPath, format, columnNames, options = {}) {
 	if (format !== "csv" && format !== "tsv" || !isGeneratedQueryPlaceholderSequence(columnNames)) return false;
+	if (options.noHeader) return true;
 	try {
 		const delimiter = format === "tsv" ? "	" : ",";
 		return (await connection.runAndReadAll(`select HasHeader from sniff_csv(${escapeSqlStringLiteral(inputPath)}, delim = ${escapeSqlStringLiteral(delimiter)})`)).getRowObjectsJson()[0]?.HasHeader === false;
@@ -1353,7 +1365,7 @@ async function collectQueryRelationColumns(connection, relationName, options) {
 	const reader = await connection.runAndReadAll(`select * from ${quoteSqlIdentifier$1(relationName)} limit 0`);
 	const columnNames = reader.deduplicatedColumnNames();
 	const columnTypes = reader.columnTypes();
-	const shouldNormalizeGeneratedColumns = await shouldNormalizeGeneratedQueryColumnNames(connection, options.inputPath, options.format, columnNames);
+	const shouldNormalizeGeneratedColumns = await shouldNormalizeGeneratedQueryColumnNames(connection, options.inputPath, options.format, columnNames, { noHeader: options.noHeader });
 	return columnNames.map((name, index) => ({
 		name: shouldNormalizeGeneratedColumns ? normalizeGeneratedQueryColumnName(name) : name,
 		sourceName: name,
@@ -1365,8 +1377,16 @@ async function collectQueryRelationColumns(connection, relationName, options) {
 function buildRelationSql(inputPath, format, shape = {}, options = {}) {
 	const escapedInput = escapeSqlStringLiteral(inputPath);
 	switch (format) {
-		case "csv": return `select * from read_csv_auto(${escapedInput}, delim = ',')`;
-		case "tsv": return `select * from read_csv_auto(${escapedInput}, delim = '\t')`;
+		case "csv": return `select * from read_csv_auto(${[
+			escapedInput,
+			"delim = ','",
+			...shape.noHeader ? ["header = false"] : []
+		].join(", ")})`;
+		case "tsv": return `select * from read_csv_auto(${[
+			escapedInput,
+			"delim = '	'",
+			...shape.noHeader ? ["header = false"] : []
+		].join(", ")})`;
 		case "parquet": return `select * from read_parquet(${escapedInput})`;
 		case "sqlite": return `select * from sqlite_scan(${escapedInput}, ${escapeSqlStringLiteral(shape.source ?? "")})`;
 		case "excel": return `select * from read_xlsx(${[
@@ -1525,8 +1545,13 @@ async function prepareDataQuerySource(connection, inputPath, format, shape = {},
 	const selectedBodyStartRow = shape.bodyStartRow !== void 0 ? normalizeExcelBodyStartRow(shape.bodyStartRow) : void 0;
 	const selectedRange = shape.range?.trim() ? normalizeExcelRange(shape.range) : void 0;
 	const selectedHeaderRow = shape.headerRow !== void 0 ? normalizeExcelHeaderRow(shape.headerRow) : void 0;
+	const noHeader = shape.noHeader === true;
 	let effectiveRange = selectedRange;
 	let boundaryRangeParts;
+	if (noHeader && format !== "csv" && format !== "tsv") throw new CliError("--no-header is only valid for CSV and TSV query inputs.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
 	if (format === "sqlite") {
 		if (selectedRange) throw new CliError("--range is only valid for Excel query inputs.", {
 			code: "INVALID_INPUT",
@@ -1594,7 +1619,8 @@ async function prepareDataQuerySource(connection, inputPath, format, shape = {},
 		});
 		const relationColumns = await collectQueryRelationColumns(connection, "file_source", {
 			format,
-			inputPath
+			inputPath,
+			noHeader
 		});
 		const appliedHeaderMappings = normalizeAndValidateAcceptedHeaderMappings({
 			availableColumns: relationColumns.map((column) => column.name),
@@ -1618,6 +1644,7 @@ async function prepareDataQuerySource(connection, inputPath, format, shape = {},
 		const excelImportMode = excelImportModes[index] ?? "default";
 		try {
 			await connection.run(`create or replace temp view file_source as ${buildRelationSql(inputPath, format, {
+				noHeader,
 				range: effectiveRange,
 				source: selectedSource
 			}, {
@@ -1626,7 +1653,8 @@ async function prepareDataQuerySource(connection, inputPath, format, shape = {},
 			})}`);
 			const relationColumns = await collectQueryRelationColumns(connection, "file_source", {
 				format,
-				inputPath
+				inputPath,
+				noHeader
 			});
 			const appliedHeaderMappings = normalizeAndValidateAcceptedHeaderMappings({
 				availableColumns: relationColumns.map((column) => column.name),
@@ -2646,6 +2674,86 @@ async function actionDataDuckDbExtensionInstall(runtime, options) {
 	}
 }
 //#endregion
+//#region src/cli/interactive/analyzer-status.ts
+const ANALYZER_WAITING_FRAMES = [
+	".  ",
+	".. ",
+	"...",
+	".. ",
+	".  "
+];
+const ANALYZER_WAITING_INTERVAL_MS = 360;
+function clearStatusLine(stream) {
+	stream.write("\r\x1B[2K");
+}
+function normalizeAnalyzerStatusMessage(message) {
+	if (message.includes("Sampling filenames")) return "sampling";
+	if (message.includes("Grouping filename patterns")) return "grouping";
+	if (message.includes("Waiting for Codex cleanup suggestions")) return "waiting";
+	return message;
+}
+function renderStatusLine(stream, message, colorEnabled) {
+	const pc = (0, import_picocolors.createColors)(colorEnabled);
+	const normalizedMessage = normalizeAnalyzerStatusMessage(message);
+	const content = ` ${pc.dim("Codex")} ${pc.white("Thinking...")} ${pc.dim(normalizedMessage)} `;
+	stream.write(`\r\x1b[2K${pc.bgBlack(content)}`);
+}
+function renderWaitingStatusLine(stream, message, tick, colorEnabled) {
+	const pc = (0, import_picocolors.createColors)(colorEnabled);
+	const normalizedMessage = normalizeAnalyzerStatusMessage(message);
+	const dots = ANALYZER_WAITING_FRAMES[tick % ANALYZER_WAITING_FRAMES.length] ?? "...";
+	const content = ` ${pc.dim("Codex")} ${pc.white("Thinking")} ${pc.dim(normalizedMessage)} ${pc.gray(dots)} `;
+	stream.write(`\r\x1b[2K${pc.bgBlack(content)}`);
+}
+function createInteractiveAnalyzerStatus(stream, colorEnabled = true) {
+	if (!stream.isTTY) return {
+		start(message) {
+			printLine(stream, message);
+		},
+		update(message) {
+			printLine(stream, message);
+		},
+		wait(message) {
+			printLine(stream, message);
+		},
+		stop() {}
+	};
+	let currentMessage = "";
+	let timer;
+	let tick = 0;
+	const stopTimer = () => {
+		if (!timer) return;
+		clearInterval(timer);
+		timer = void 0;
+	};
+	return {
+		start(message) {
+			stopTimer();
+			currentMessage = message;
+			renderStatusLine(stream, currentMessage, colorEnabled);
+		},
+		update(message) {
+			stopTimer();
+			currentMessage = message;
+			renderStatusLine(stream, currentMessage, colorEnabled);
+		},
+		wait(message) {
+			stopTimer();
+			currentMessage = message;
+			tick = 0;
+			renderWaitingStatusLine(stream, currentMessage, tick, colorEnabled);
+			timer = setInterval(() => {
+				tick += 1;
+				renderWaitingStatusLine(stream, currentMessage, tick, colorEnabled);
+			}, ANALYZER_WAITING_INTERVAL_MS);
+		},
+		stop() {
+			stopTimer();
+			clearStatusLine(stream);
+		}
+	};
+}
+//#endregion
 //#region src/cli/data-workflows/header-mapping-flow.ts
 function classifyHeaderSuggestionFailure(message, options) {
 	if (/codex exec exited/i.test(message) || /missing optional dependency/i.test(message) || /spawn/i.test(message) || /enoent/i.test(message) || /auth/i.test(message) || /sign in/i.test(message) || /api key/i.test(message)) return {
@@ -2682,6 +2790,7 @@ function buildHeaderSuggestionFollowUpCommand(options) {
 		options.format,
 		...options.shape.source ? ["--source", JSON.stringify(options.shape.source)] : [],
 		...options.shape.range ? ["--range", options.shape.range] : [],
+		...options.shape.noHeader ? ["--no-header"] : [],
 		...options.shape.bodyStartRow !== void 0 ? ["--body-start-row", String(options.shape.bodyStartRow)] : [],
 		...options.shape.headerRow !== void 0 ? ["--header-row", String(options.shape.headerRow)] : [],
 		"--header-mapping",
@@ -2702,13 +2811,21 @@ async function resolveReusableHeaderMappingsForDataFlow(options) {
 }
 async function runCodexHeaderSuggestionFlow(options) {
 	const artifactPath = options.writeHeaderMapping?.trim() ? resolveFromCwd(options.runtime, options.writeHeaderMapping.trim()) : (0, node_path.join)(options.runtime.cwd, generateDataHeaderMappingFileName());
-	const introspection = await options.collectIntrospection();
-	const suggestionResult = await suggestDataHeaderMappingsWithCodex({
-		format: options.format,
-		introspection,
-		runner: options.headerSuggestionRunner,
-		workingDirectory: options.runtime.cwd
-	});
+	const status = createInteractiveAnalyzerStatus(options.runtime.stdout, options.runtime.colorEnabled);
+	let suggestionResult;
+	try {
+		status.start("Inspecting shaped source");
+		const introspection = await options.collectIntrospection();
+		status.wait("Waiting for Codex header suggestions");
+		suggestionResult = await suggestDataHeaderMappingsWithCodex({
+			format: options.format,
+			introspection,
+			runner: options.headerSuggestionRunner,
+			workingDirectory: options.runtime.cwd
+		});
+	} finally {
+		status.stop();
+	}
 	if (suggestionResult.errorMessage) {
 		const failure = classifyHeaderSuggestionFailure(suggestionResult.errorMessage, {
 			failureCode: options.failureCode,
@@ -2999,7 +3116,7 @@ function buildSourceShapeHeaderSuggestionFollowUpCommand(options) {
 	].join(" ");
 }
 async function resolveReusableSourceShapeForDataFlow(options) {
-	if (!isSourceShapeFormat(options.format)) throw new CliError("--source-shape is only valid for Excel extract inputs.", {
+	if (!isSourceShapeFormat(options.format)) throw new CliError(`--source-shape is only valid for Excel ${options.commandName} inputs.`, {
 		code: "INVALID_INPUT",
 		exitCode: 2
 	});
@@ -3166,14 +3283,18 @@ async function runCodexSourceShapeSuggestionFlow(runtime, options) {
 	});
 	const selectedSource = assertNonEmpty(options.source, "Source");
 	const artifactPath = options.writeSourceShape?.trim() ? resolveFromCwd(runtime, options.writeSourceShape.trim()) : (0, node_path.join)(runtime.cwd, generateDataSourceShapeFileName());
+	const status = createInteractiveAnalyzerStatus(runtime.stdout, runtime.colorEnabled);
 	let connection;
 	try {
 		connection = await createDuckDbConnection$1();
+		status.start("Inspecting worksheet structure");
 		const currentIntrospection = await collectDataQuerySourceIntrospection(connection, options.inputPath, options.format, { source: selectedSource }, 5);
+		const sheetSnapshot = await collectXlsxSheetSnapshot(options.inputPath, selectedSource, { maxRows: 24 });
+		status.wait("Waiting for Codex source-shape suggestions");
 		const suggestionResult = await suggestDataSourceShapeWithCodex({
 			context: {
 				currentIntrospection,
-				sheetSnapshot: await collectXlsxSheetSnapshot(options.inputPath, selectedSource, { maxRows: 24 })
+				sheetSnapshot
 			},
 			currentBodyStartRow: currentIntrospection.selectedBodyStartRow,
 			currentHeaderRow: currentIntrospection.selectedHeaderRow,
@@ -3181,6 +3302,7 @@ async function runCodexSourceShapeSuggestionFlow(runtime, options) {
 			runner: options.sourceShapeSuggestionRunner,
 			workingDirectory: runtime.cwd
 		});
+		status.stop();
 		if (suggestionResult.errorMessage || !suggestionResult.shape || !suggestionResult.reasoningSummary) {
 			const failure = classifySourceShapeSuggestionFailure(suggestionResult.errorMessage ?? "Codex did not return a valid source-shape suggestion.");
 			throw new CliError(`${failure.prefix}: ${suggestionResult.errorMessage ?? "Codex did not return a valid source-shape suggestion."}`, {
@@ -3220,6 +3342,7 @@ async function runCodexSourceShapeSuggestionFlow(runtime, options) {
 			runtime
 		}));
 	} finally {
+		status.stop();
 		connection?.closeSync();
 	}
 }
@@ -3295,6 +3418,11 @@ async function actionDataExtract(runtime, options) {
 	const format = detectDataQueryInputFormat(inputPath, options.inputFormat);
 	const bodyStartRow = options.bodyStartRow;
 	const headerRow = options.headerRow;
+	const noHeader = options.noHeader === true;
+	if (noHeader && format !== "csv" && format !== "tsv") throw new CliError("--no-header is only valid for CSV and TSV extract inputs.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
 	const explicitRange = options.range?.trim() || void 0;
 	const explicitSource = options.source?.trim() || void 0;
 	if (options.codexSuggestShape) {
@@ -3309,6 +3437,7 @@ async function actionDataExtract(runtime, options) {
 		return;
 	}
 	const resolvedSourceShape = options.sourceShape?.trim() ? await resolveReusableSourceShapeForDataFlow({
+		commandName: "extract",
 		format,
 		inputPath,
 		runtime,
@@ -3329,6 +3458,7 @@ async function actionDataExtract(runtime, options) {
 				shape: {
 					bodyStartRow: effectiveBodyStartRow,
 					headerRow: effectiveHeaderRow,
+					noHeader,
 					range,
 					source
 				},
@@ -3338,6 +3468,7 @@ async function actionDataExtract(runtime, options) {
 				collectIntrospection: async () => await collectDataQuerySourceIntrospection(connection, inputPath, format, {
 					bodyStartRow: effectiveBodyStartRow,
 					headerRow: effectiveHeaderRow,
+					noHeader,
 					range,
 					source
 				}, 5),
@@ -3360,6 +3491,7 @@ async function actionDataExtract(runtime, options) {
 		shape: {
 			...effectiveBodyStartRow !== void 0 ? { bodyStartRow: effectiveBodyStartRow } : {},
 			...effectiveHeaderRow !== void 0 ? { headerRow: effectiveHeaderRow } : {},
+			...noHeader ? { noHeader: true } : {},
 			range,
 			source
 		}
@@ -3371,6 +3503,7 @@ async function actionDataExtract(runtime, options) {
 			bodyStartRow: effectiveBodyStartRow,
 			headerMappings: resolvedHeaderMappings,
 			headerRow: effectiveHeaderRow,
+			noHeader,
 			range,
 			source
 		});
@@ -3522,6 +3655,22 @@ function validateDataQueryOptions(options) {
 		code: "INVALID_INPUT",
 		exitCode: 2
 	});
+	if (options.sourceShape?.trim() && options.source?.trim()) throw new CliError("--source-shape cannot be used together with --source in the current replay flow.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
+	if (options.sourceShape?.trim() && options.range?.trim()) throw new CliError("--source-shape cannot be used together with --range in the current replay flow.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
+	if (options.sourceShape?.trim() && options.headerRow !== void 0) throw new CliError("--source-shape cannot be used together with --header-row in the current replay flow.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
+	if (options.sourceShape?.trim() && options.bodyStartRow !== void 0) throw new CliError("--source-shape cannot be used together with --body-start-row in the current replay flow.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
 }
 function isDuckDbBuiltInQueryFormat(format) {
 	return format === "csv" || format === "tsv" || format === "parquet";
@@ -3545,12 +3694,29 @@ async function actionDataQuery(runtime, options) {
 	const format = detectDataQueryInputFormat(inputPath, options.inputFormat);
 	const bodyStartRow = options.bodyStartRow;
 	const headerRow = options.headerRow;
+	const noHeader = options.noHeader === true;
+	if (noHeader && format !== "csv" && format !== "tsv") throw new CliError("--no-header is only valid for CSV and TSV query inputs.", {
+		code: "INVALID_INPUT",
+		exitCode: 2
+	});
 	if (options.installMissingExtension && isDuckDbBuiltInQueryFormat(format)) throw new CliError("--install-missing-extension is only valid for extension-backed query formats (sqlite, excel).", {
 		code: "INVALID_INPUT",
 		exitCode: 2
 	});
-	const range = options.range?.trim() || void 0;
-	const source = options.source?.trim() || void 0;
+	const explicitRange = options.range?.trim() || void 0;
+	const explicitSource = options.source?.trim() || void 0;
+	const resolvedSourceShape = options.sourceShape?.trim() ? await resolveReusableSourceShapeForDataFlow({
+		commandName: "query",
+		format,
+		inputPath,
+		runtime,
+		source: explicitSource,
+		sourceShapePath: resolveFromCwd(runtime, options.sourceShape.trim())
+	}) : void 0;
+	const range = resolvedSourceShape?.range ?? explicitRange;
+	const source = resolvedSourceShape?.source ?? explicitSource;
+	const effectiveBodyStartRow = resolvedSourceShape?.bodyStartRow ?? bodyStartRow;
+	const effectiveHeaderRow = resolvedSourceShape?.headerRow ?? headerRow;
 	const rowCount = options.rows ?? DEFAULT_QUERY_ROWS;
 	if (options.codexSuggestHeaders) {
 		const collectSourceIntrospection = options.sourceIntrospectionCollector ?? collectDataQuerySourceIntrospection;
@@ -3561,18 +3727,20 @@ async function actionDataQuery(runtime, options) {
 				format,
 				inputPath,
 				shape: {
-					bodyStartRow,
+					bodyStartRow: effectiveBodyStartRow,
 					range,
-					headerRow,
+					headerRow: effectiveHeaderRow,
+					noHeader,
 					source
 				},
 				overwrite: options.overwrite,
 				writeHeaderMapping: options.writeHeaderMapping,
 				headerSuggestionRunner: options.headerSuggestionRunner,
 				collectIntrospection: async () => await collectSourceIntrospection(connection, inputPath, format, {
-					bodyStartRow,
+					bodyStartRow: effectiveBodyStartRow,
 					range,
-					headerRow,
+					headerRow: effectiveHeaderRow,
+					noHeader,
 					source
 				}, DATA_QUERY_HEADER_SUGGESTION_SAMPLE_ROWS, {
 					installMissingExtension: options.installMissingExtension,
@@ -3595,9 +3763,10 @@ async function actionDataQuery(runtime, options) {
 		inputPath,
 		runtime,
 		shape: {
-			bodyStartRow,
+			...effectiveBodyStartRow !== void 0 ? { bodyStartRow: effectiveBodyStartRow } : {},
 			range,
-			headerRow,
+			...effectiveHeaderRow !== void 0 ? { headerRow: effectiveHeaderRow } : {},
+			noHeader,
 			source
 		}
 	}) : void 0;
@@ -3606,9 +3775,10 @@ async function actionDataQuery(runtime, options) {
 	try {
 		connection = await createDuckDbConnection$1();
 		const preparedSource = await prepareDataQuerySource(connection, inputPath, format, {
-			bodyStartRow,
+			bodyStartRow: effectiveBodyStartRow,
 			headerMappings: resolvedHeaderMappings,
-			headerRow,
+			headerRow: effectiveHeaderRow,
+			noHeader,
 			range,
 			source
 		}, {
@@ -3651,86 +3821,6 @@ async function actionDataQuery(runtime, options) {
 	}
 }
 //#endregion
-//#region src/cli/interactive/analyzer-status.ts
-const ANALYZER_WAITING_FRAMES = [
-	".  ",
-	".. ",
-	"...",
-	".. ",
-	".  "
-];
-const ANALYZER_WAITING_INTERVAL_MS = 360;
-function clearStatusLine(stream) {
-	stream.write("\r\x1B[2K");
-}
-function normalizeAnalyzerStatusMessage(message) {
-	if (message.includes("Sampling filenames")) return "sampling";
-	if (message.includes("Grouping filename patterns")) return "grouping";
-	if (message.includes("Waiting for Codex cleanup suggestions")) return "waiting";
-	return message;
-}
-function renderStatusLine(stream, message, colorEnabled) {
-	const pc = (0, import_picocolors.createColors)(colorEnabled);
-	const normalizedMessage = normalizeAnalyzerStatusMessage(message);
-	const content = ` ${pc.dim("Codex")} ${pc.white("Thinking...")} ${pc.dim(normalizedMessage)} `;
-	stream.write(`\r\x1b[2K${pc.bgBlack(content)}`);
-}
-function renderWaitingStatusLine(stream, message, tick, colorEnabled) {
-	const pc = (0, import_picocolors.createColors)(colorEnabled);
-	const normalizedMessage = normalizeAnalyzerStatusMessage(message);
-	const dots = ANALYZER_WAITING_FRAMES[tick % ANALYZER_WAITING_FRAMES.length] ?? "...";
-	const content = ` ${pc.dim("Codex")} ${pc.white("Thinking")} ${pc.dim(normalizedMessage)} ${pc.gray(dots)} `;
-	stream.write(`\r\x1b[2K${pc.bgBlack(content)}`);
-}
-function createInteractiveAnalyzerStatus(stream, colorEnabled = true) {
-	if (!stream.isTTY) return {
-		start(message) {
-			printLine(stream, message);
-		},
-		update(message) {
-			printLine(stream, message);
-		},
-		wait(message) {
-			printLine(stream, message);
-		},
-		stop() {}
-	};
-	let currentMessage = "";
-	let timer;
-	let tick = 0;
-	const stopTimer = () => {
-		if (!timer) return;
-		clearInterval(timer);
-		timer = void 0;
-	};
-	return {
-		start(message) {
-			stopTimer();
-			currentMessage = message;
-			renderStatusLine(stream, currentMessage, colorEnabled);
-		},
-		update(message) {
-			stopTimer();
-			currentMessage = message;
-			renderStatusLine(stream, currentMessage, colorEnabled);
-		},
-		wait(message) {
-			stopTimer();
-			currentMessage = message;
-			tick = 0;
-			renderWaitingStatusLine(stream, currentMessage, tick, colorEnabled);
-			timer = setInterval(() => {
-				tick += 1;
-				renderWaitingStatusLine(stream, currentMessage, tick, colorEnabled);
-			}, ANALYZER_WAITING_INTERVAL_MS);
-		},
-		stop() {
-			stopTimer();
-			clearStatusLine(stream);
-		}
-	};
-}
-//#endregion
 //#region src/cli/data-query/codex.ts
 const DATA_QUERY_CODEX_OUTPUT_SCHEMA = {
 	type: "object",
@@ -9626,6 +9716,13 @@ async function promptOptionalSourceSelection(format, sources) {
 		}))
 	});
 }
+async function promptDelimitedHeaderMode(format) {
+	if (format !== "csv" && format !== "tsv") return;
+	return await (0, _inquirer_prompts.confirm)({
+		message: "Treat CSV/TSV input as headerless?",
+		default: false
+	});
+}
 //#endregion
 //#region src/cli/interactive/data-query/types.ts
 const QUERY_CONTINUATION_LABELS = {
@@ -9749,7 +9846,7 @@ function renderIntrospectionSummary(runtime, options) {
 }
 async function collectInteractiveIntrospection(options) {
 	const labels = options.labels ?? QUERY_CONTINUATION_LABELS;
-	let sourceShape = {};
+	let sourceShape = options.initialNoHeader ? { selectedNoHeader: true } : {};
 	let cachedSheetSnapshot;
 	const getSheetSnapshot = async () => {
 		const selectedSource = options.selectedSource?.trim();
@@ -9767,6 +9864,7 @@ async function collectInteractiveIntrospection(options) {
 		const introspection = await collectDataQuerySourceIntrospection(options.connection, options.inputPath, options.format, {
 			bodyStartRow: sourceShape.selectedBodyStartRow,
 			headerRow: sourceShape.selectedHeaderRow,
+			noHeader: sourceShape.selectedNoHeader,
 			range: sourceShape.selectedRange,
 			source: options.selectedSource
 		}, DATA_QUERY_INTERACTIVE_SAMPLE_ROWS$1);
@@ -9992,6 +10090,7 @@ async function reviewInteractiveHeaderMappings(options) {
 				bodyStartRow: options.selectedBodyStartRow,
 				headerMappings: acceptedMappings,
 				headerRow: options.selectedHeaderRow,
+				noHeader: options.selectedNoHeader,
 				range: options.selectedRange,
 				source: options.selectedSource
 			}, DATA_QUERY_INTERACTIVE_SAMPLE_ROWS);
@@ -10121,6 +10220,7 @@ async function executeInteractiveCandidate(runtime, pathPromptContext, options)
 				...options.headerMappings ? { headerMappings: options.headerMappings } : {},
 				...options.selectedBodyStartRow !== void 0 ? { bodyStartRow: options.selectedBodyStartRow } : {},
 				...options.selectedHeaderRow !== void 0 ? { headerRow: options.selectedHeaderRow } : {},
+				...options.selectedNoHeader ? { noHeader: true } : {},
 				...options.selectedRange ? { range: options.selectedRange } : {},
 				...options.selectedSource ? { source: options.selectedSource } : {},
 				sql: options.sql
@@ -10200,6 +10300,7 @@ async function runCodexInteractiveQuery(runtime, pathPromptContext, options) {
 					input: options.input,
 					selectedBodyStartRow: options.selectedBodyStartRow,
 					selectedHeaderRow: options.selectedHeaderRow,
+					selectedNoHeader: options.selectedNoHeader,
 					selectedRange: options.selectedRange,
 					selectedSource: options.selectedSource,
 					sql: draftResult.draft.sql
@@ -10446,6 +10547,7 @@ async function runFormalGuideInteractiveQuery(runtime, pathPromptContext, option
 			input: options.input,
 			selectedBodyStartRow: options.selectedBodyStartRow,
 			selectedHeaderRow: options.selectedHeaderRow,
+			selectedNoHeader: options.selectedNoHeader,
 			selectedRange: options.selectedRange,
 			selectedSource: options.selectedSource,
 			sql
@@ -10477,6 +10579,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 	});
 	const inputPath = resolveFromCwd(runtime, input);
 	const format = await promptInteractiveInputFormat(runtime, inputPath);
+	const noHeader = await promptDelimitedHeaderMode(format);
 	let connection;
 	try {
 		connection = await createDuckDbConnection$1();
@@ -10484,6 +10587,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 		const { introspection, sourceShape } = await collectInteractiveIntrospection({
 			connection,
 			format,
+			initialNoHeader: noHeader,
 			inputPath,
 			labels: QUERY_CONTINUATION_LABELS,
 			runtime,
@@ -10498,6 +10602,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 			runtime,
 			selectedBodyStartRow: sourceShape.selectedBodyStartRow,
 			selectedHeaderRow: sourceShape.selectedHeaderRow,
+			selectedNoHeader: sourceShape.selectedNoHeader,
 			selectedRange: sourceShape.selectedRange,
 			selectedSource
 		});
@@ -10525,6 +10630,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 				input,
 				selectedBodyStartRow: sourceShape.selectedBodyStartRow,
 				selectedHeaderRow: sourceShape.selectedHeaderRow,
+				selectedNoHeader: sourceShape.selectedNoHeader,
 				selectedRange: sourceShape.selectedRange,
 				selectedSource
 			});
@@ -10538,6 +10644,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 				headerMappings: reviewedHeaders.headerMappings,
 				selectedBodyStartRow: sourceShape.selectedBodyStartRow,
 				selectedHeaderRow: sourceShape.selectedHeaderRow,
+				selectedNoHeader: sourceShape.selectedNoHeader,
 				selectedRange: sourceShape.selectedRange,
 				selectedSource
 			});
@@ -10550,6 +10657,7 @@ async function runInteractiveDataQuery(runtime, pathPromptContext) {
 			headerMappings: reviewedHeaders.headerMappings,
 			selectedBodyStartRow: sourceShape.selectedBodyStartRow,
 			selectedHeaderRow: sourceShape.selectedHeaderRow,
+			selectedNoHeader: sourceShape.selectedNoHeader,
 			selectedRange: sourceShape.selectedRange,
 			selectedSource
 		});
@@ -10653,6 +10761,7 @@ async function runInteractiveDataExtract(runtime, pathPromptContext) {
 	});
 	const inputPath = resolveFromCwd(runtime, input);
 	const format = await promptInteractiveInputFormat(runtime, inputPath);
+	const noHeader = await promptDelimitedHeaderMode(format);
 	let connection;
 	try {
 		connection = await createDuckDbConnection$1();
@@ -10660,6 +10769,7 @@ async function runInteractiveDataExtract(runtime, pathPromptContext) {
 		const { introspection, sourceShape } = await collectInteractiveIntrospection({
 			connection,
 			format,
+			initialNoHeader: noHeader,
 			inputPath,
 			labels: EXTRACT_CONTINUATION_LABELS,
 			runtime,
@@ -10674,6 +10784,7 @@ async function runInteractiveDataExtract(runtime, pathPromptContext) {
 			runtime,
 			selectedBodyStartRow: sourceShape.selectedBodyStartRow,
 			selectedHeaderRow: sourceShape.selectedHeaderRow,
+			selectedNoHeader: sourceShape.selectedNoHeader,
 			selectedRange: sourceShape.selectedRange,
 			selectedSource
 		});
@@ -10690,6 +10801,7 @@ async function runInteractiveDataExtract(runtime, pathPromptContext) {
 			...reviewedHeaders.headerMappings ? { headerMappings: reviewedHeaders.headerMappings } : {},
 			input,
 			inputFormat: format,
+			...sourceShape.selectedNoHeader ? { noHeader: true } : {},
 			output: outputOptions.output,
 			overwrite: outputOptions.overwrite,
 			...sourceShape.selectedBodyStartRow !== void 0 ? { bodyStartRow: sourceShape.selectedBodyStartRow } : {},
@@ -12362,7 +12474,7 @@ function registerDataDuckDbCommands(dataCommand, runtime) {
 //#endregion
 //#region src/cli/commands/data/extract.ts
 function registerDataExtractCommand(dataCommand, runtime) {
-	dataCommand.command("extract").description("Materialize one shaped table from one input file").argument("<input>", "Input data file").option("--input-format <format>", `Override detected input format (${DATA_QUERY_INPUT_FORMAT_VALUES.join(", ")})`, parseDataQueryInputFormatOption).option("--source <name>", "Source object name for SQLite tables/views or Excel sheets").option("--range <A1:Z99>", "Excel cell range within the selected sheet").option("--body-start-row <value>", "Excel worksheet row number where logical body rows begin", (value) => parsePositiveIntegerOption(value, "--body-start-row")).option("--header-row <value>", "Excel worksheet row number to treat as the header row", (value) => parsePositiveIntegerOption(value, "--header-row")).option("--source-shape <path>", "Reuse an accepted JSON source-shape artifact").option("--codex-suggest-shape", "Ask Codex to suggest an explicit Excel source shape and stop after writing the review artifact", false).option("--write-source-shape <path>", "Write the suggested source-shape artifact to an explicit path").option("--header-mapping <path>", "Reuse an accepted JSON header-mapping artifact").option("--codex-suggest-headers", "Ask Codex to suggest semantic header mappings and stop after writing the review artifact", false).option("--write-header-mapping <path>", "Write the suggested header-mapping artifact to an explicit path").option("-o, --output <path>", "Write the shaped table to a .csv, .tsv, or .json file").option("--overwrite", "Overwrite output file if it already exists", false).action(async (input, options) => {
+	dataCommand.command("extract").description("Materialize one shaped table from one input file").argument("<input>", "Input data file").option("--input-format <format>", `Override detected input format (${DATA_QUERY_INPUT_FORMAT_VALUES.join(", ")})`, parseDataQueryInputFormatOption).option("--source <name>", "Source object name for SQLite tables/views or Excel sheets").option("--range <A1:Z99>", "Excel cell range within the selected sheet").option("--no-header", "Treat CSV or TSV input as headerless and generate column_n names").option("--body-start-row <value>", "Excel worksheet row number where logical body rows begin", (value) => parsePositiveIntegerOption(value, "--body-start-row")).option("--header-row <value>", "Excel worksheet row number to treat as the header row", (value) => parsePositiveIntegerOption(value, "--header-row")).option("--source-shape <path>", "Reuse an accepted JSON source-shape artifact").option("--codex-suggest-shape", "Ask Codex to suggest an explicit Excel source shape and stop after writing the review artifact", false).option("--write-source-shape <path>", "Write the suggested source-shape artifact to an explicit path").option("--header-mapping <path>", "Reuse an accepted JSON header-mapping artifact").option("--codex-suggest-headers", "Ask Codex to suggest semantic header mappings and stop after writing the review artifact", false).option("--write-header-mapping <path>", "Write the suggested header-mapping artifact to an explicit path").option("-o, --output <path>", "Write the shaped table to a .csv, .tsv, or .json file").option("--overwrite", "Overwrite output file if it already exists", false).action(async (input, options) => {
 		await actionDataExtract(runtime, {
 			bodyStartRow: options.bodyStartRow,
 			codexSuggestShape: options.codexSuggestShape,
@@ -12371,6 +12483,7 @@ function registerDataExtractCommand(dataCommand, runtime) {
 			headerRow: options.headerRow,
 			input,
 			inputFormat: options.inputFormat,
+			noHeader: options.noHeader ?? options.header === false,
 			output: options.output,
 			overwrite: options.overwrite,
 			range: options.range,
@@ -12406,7 +12519,7 @@ function registerDataPreviewCommands(dataCommand, runtime) {
 //#endregion
 //#region src/cli/commands/data/query.ts
 function registerDataQueryCommands(dataCommand, runtime) {
-	dataCommand.command("query").description("Run a DuckDB-backed SQL query against one input file").argument("<input>", "Input data file").option("--sql <query>", "SQL query to execute against logical table `file`").option("--input-format <format>", `Override detected input format (${DATA_QUERY_INPUT_FORMAT_VALUES.join(", ")})`, parseDataQueryInputFormatOption).option("--source <name>", "Source object name for SQLite tables/views or Excel sheets").option("--range <A1:Z99>", "Excel cell range within the selected sheet").option("--body-start-row <value>", "Excel worksheet row number where logical body rows begin", (value) => parsePositiveIntegerOption(value, "--body-start-row")).option("--header-row <value>", "Excel worksheet row number to treat as the header row", (value) => parsePositiveIntegerOption(value, "--header-row")).option("--header-mapping <path>", "Reuse an accepted JSON header-mapping artifact").option("--codex-suggest-headers", "Ask Codex to suggest semantic header mappings and stop after writing the review artifact", false).option("--write-header-mapping <path>", "Write the suggested header-mapping artifact to an explicit path").option("--install-missing-extension", "Attempt one DuckDB extension install-and-retry for sqlite/excel inputs", false).option("--rows <value>", "Number of rows to show in bounded table output", (value) => parsePositiveIntegerOption(value, "--rows")).option("--json", "Write full query results as JSON to stdout", false).option("--pretty", "Pretty-print JSON stdout or .json file output", false).option("-o, --output <path>", "Write full query results to a .json or .csv file").option("--overwrite", "Overwrite output file if it already exists", false).action(async (input, options) => {
+	dataCommand.command("query").description("Run a DuckDB-backed SQL query against one input file").argument("<input>", "Input data file").option("--sql <query>", "SQL query to execute against logical table `file`").option("--input-format <format>", `Override detected input format (${DATA_QUERY_INPUT_FORMAT_VALUES.join(", ")})`, parseDataQueryInputFormatOption).option("--source <name>", "Source object name for SQLite tables/views or Excel sheets").option("--range <A1:Z99>", "Excel cell range within the selected sheet").option("--source-shape <path>", "Reuse an accepted JSON source-shape artifact for Excel query replay").option("--no-header", "Treat CSV or TSV input as headerless and generate column_n names").option("--body-start-row <value>", "Excel worksheet row number where logical body rows begin", (value) => parsePositiveIntegerOption(value, "--body-start-row")).option("--header-row <value>", "Excel worksheet row number to treat as the header row", (value) => parsePositiveIntegerOption(value, "--header-row")).option("--header-mapping <path>", "Reuse an accepted JSON header-mapping artifact").option("--codex-suggest-headers", "Ask Codex to suggest semantic header mappings and stop after writing the review artifact", false).option("--write-header-mapping <path>", "Write the suggested header-mapping artifact to an explicit path").option("--install-missing-extension", "Attempt one DuckDB extension install-and-retry for sqlite/excel inputs", false).option("--rows <value>", "Number of rows to show in bounded table output", (value) => parsePositiveIntegerOption(value, "--rows")).option("--json", "Write full query results as JSON to stdout", false).option("--pretty", "Pretty-print JSON stdout or .json file output", false).option("-o, --output <path>", "Write full query results to a .json or .csv file").option("--overwrite", "Overwrite output file if it already exists", false).action(async (input, options) => {
 		await actionDataQuery(runtime, {
 			bodyStartRow: options.bodyStartRow,
 			codexSuggestHeaders: options.codexSuggestHeaders,
@@ -12416,11 +12529,13 @@ function registerDataQueryCommands(dataCommand, runtime) {
 			inputFormat: options.inputFormat,
 			installMissingExtension: options.installMissingExtension,
 			json: options.json,
+			noHeader: options.noHeader ?? options.header === false,
 			output: options.output,
 			overwrite: options.overwrite,
 			pretty: options.pretty,
 			range: options.range,
 			rows: options.rows,
+			sourceShape: options.sourceShape,
 			source: options.source,
 			sql: options.sql,
 			writeHeaderMapping: options.writeHeaderMapping
@@ -12587,7 +12702,7 @@ function registerCliCommands(program, runtime) {
 }
 //#endregion
 //#region src/cli/program/version-embedded.ts
-const EMBEDDED_PACKAGE_VERSION = "0.0.8";
+const EMBEDDED_PACKAGE_VERSION = "0.0.9-canary.2";
 //#endregion
 //#region src/cli/program/version.ts
 function* candidateSearchRoots() {
@@ -12620,7 +12735,7 @@ function normalizeVersion(value) {
 	return trimmed;
 }
 function resolvePackageVersion(options = {}) {
-	const embeddedVersion = normalizeVersion(options.embeddedVersion ?? "0.0.8");
+	const embeddedVersion = normalizeVersion(options.embeddedVersion ?? "0.0.9-canary.2");
 	if (embeddedVersion) return embeddedVersion;
 	const maxLevels = options.maxLevels ?? 8;
 	const resolveFromPath = options.resolveFromPath ?? resolveVersionFromPath;