@warlock.js/core 5.30.0 → 5.31.0

package/esm/tooling/generate/unified-diff.mjs

@@ -0,0 +1,161 @@
+//#region ../../packages/core/src/tooling/generate/unified-diff.ts
+/**
+* A small, dependency-free unified diff, in the format `git diff` and
+* `patch -p1` read: `--- a/<path>` / `+++ b/<path>` headers (`/dev/null` for a
+* created or deleted file), `@@ -l,c +l,c @@` hunks with three lines of
+* context, and `` markers.
+*
+* Lines are matched with a longest-common-subsequence table after the common
+* prefix and suffix are trimmed. Generated files are small, so that is plenty;
+* a pair too large for the table falls back to "every line replaced", which is
+* still a correct (if larger) diff.
+*/
+/** Lines of context around each change. */
+const DIFF_CONTEXT_LINES = 3;
+/** Above this many table cells the LCS falls back to a full replace. */
+const MAX_LCS_CELLS = 4e6;
+/** A marker appended to the compare key of a last line without a newline. */
+const NO_EOL = "\0no-eol";
+/** Split text into compare keys: one per line, the last one marked when it has no newline. */
+function toLines(text) {
+	if (text.length === 0) return [];
+	const lines = text.split("\n");
+	if (lines[lines.length - 1] === "") {
+		lines.pop();
+		return lines;
+	}
+	const last = lines.length - 1;
+	return lines.map((line, index) => index === last ? `${line}${NO_EOL}` : line);
+}
+/** The edit script turning `before` into `after`. */
+function diffLines(before, after) {
+	let prefix = 0;
+	while (prefix < before.length && prefix < after.length && before[prefix] === after[prefix]) prefix++;
+	let suffix = 0;
+	while (suffix < before.length - prefix && suffix < after.length - prefix && before[before.length - 1 - suffix] === after[after.length - 1 - suffix]) suffix++;
+	const head = before.slice(0, prefix).map((key) => ({
+		type: " ",
+		key
+	}));
+	const tail = before.slice(before.length - suffix).map((key) => ({
+		type: " ",
+		key
+	}));
+	const oldMiddle = before.slice(prefix, before.length - suffix);
+	const newMiddle = after.slice(prefix, after.length - suffix);
+	return [
+		...head,
+		...diffMiddle(oldMiddle, newMiddle),
+		...tail
+	];
+}
+/** LCS-based edit script for the part that differs. */
+function diffMiddle(before, after) {
+	const rows = before.length;
+	const columns = after.length;
+	if (rows === 0 || columns === 0 || (rows + 1) * (columns + 1) > MAX_LCS_CELLS) return [...before.map((key) => ({
+		type: "-",
+		key
+	})), ...after.map((key) => ({
+		type: "+",
+		key
+	}))];
+	const width = columns + 1;
+	const table = new Uint32Array((rows + 1) * width);
+	for (let i = rows - 1; i >= 0; i--) for (let j = columns - 1; j >= 0; j--) table[i * width + j] = before[i] === after[j] ? (table[(i + 1) * width + j + 1] ?? 0) + 1 : Math.max(table[(i + 1) * width + j] ?? 0, table[i * width + j + 1] ?? 0);
+	const operations = [];
+	let i = 0;
+	let j = 0;
+	while (i < rows && j < columns) {
+		const oldLine = before[i] ?? "";
+		const newLine = after[j] ?? "";
+		if (oldLine === newLine) {
+			operations.push({
+				type: " ",
+				key: oldLine
+			});
+			i++;
+			j++;
+		} else if ((table[(i + 1) * width + j] ?? 0) >= (table[i * width + j + 1] ?? 0)) {
+			operations.push({
+				type: "-",
+				key: oldLine
+			});
+			i++;
+		} else {
+			operations.push({
+				type: "+",
+				key: newLine
+			});
+			j++;
+		}
+	}
+	for (; i < rows; i++) operations.push({
+		type: "-",
+		key: before[i] ?? ""
+	});
+	for (; j < columns; j++) operations.push({
+		type: "+",
+		key: after[j] ?? ""
+	});
+	return operations;
+}
+function renderLine(operation) {
+	if (operation.key.endsWith(NO_EOL)) return `${operation.type}${operation.key.slice(0, -7)}\n\`;
+	return `${operation.type}${operation.key}`;
+}
+/** `start,count` of one side of a hunk header, GNU style (a zero count names the line before). */
+function range(start, count) {
+	return `${count === 0 ? start : start + 1},${count}`;
+}
+/**
+* The unified diff between two versions of one file, or `""` when they are
+* equal.
+*
+* @example
+* unifiedDiff({ path: "src/app/users/routes.ts", before: "a\n", after: "a\nb\n" });
+* // --- a/src/app/users/routes.ts
+* // +++ b/src/app/users/routes.ts
+* // @@ -1,1 +1,2 @@
+* //  a
+* // +b
+*/
+function unifiedDiff(input) {
+	const context = input.context ?? 3;
+	if (input.before !== null && input.after !== null && input.before === input.after) return "";
+	const operations = diffLines(toLines(input.before ?? ""), toLines(input.after ?? ""));
+	const changes = operations.flatMap((operation, index) => operation.type === " " ? [] : [index]);
+	const header = [input.before === null ? "--- /dev/null" : `--- a/${input.path}`, input.after === null ? "+++ /dev/null" : `+++ b/${input.path}`];
+	if (changes.length === 0) return `${header.join("\n")}\n`;
+	const groups = [];
+	for (const index of changes) {
+		const current = groups[groups.length - 1];
+		if (current && index - current.last - 1 <= context * 2) current.last = index;
+		else groups.push({
+			first: index,
+			last: index
+		});
+	}
+	const lines = [...header];
+	for (const group of groups) {
+		const from = Math.max(0, group.first - context);
+		const to = Math.min(operations.length - 1, group.last + context);
+		let oldStart = 0;
+		let newStart = 0;
+		for (let index = 0; index < from; index++) {
+			const type = operations[index]?.type;
+			if (type !== "+") oldStart++;
+			if (type !== "-") newStart++;
+		}
+		const slice = operations.slice(from, to + 1);
+		const oldCount = slice.filter((operation) => operation.type !== "+").length;
+		const newCount = slice.filter((operation) => operation.type !== "-").length;
+		lines.push(`@@ -${range(oldStart, oldCount)} +${range(newStart, newCount)} @@`);
+		lines.push(...slice.map(renderLine));
+	}
+	return `${lines.join("\n")}\n`;
+}
+
+//#endregion
+export { DIFF_CONTEXT_LINES, unifiedDiff };
+//# sourceMappingURL=unified-diff.mjs.map

package/esm/tooling/generate/unified-diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-diff.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/unified-diff.ts"],"sourcesContent":["/**\n * A small, dependency-free unified diff, in the format `git diff` and\n * `patch -p1` read: `--- a/<path>` / `+++ b/<path>` headers (`/dev/null` for a\n * created or deleted file), `@@ -l,c +l,c @@` hunks with three lines of\n * context, and `\` markers.\n *\n * Lines are matched with a longest-common-subsequence table after the common\n * prefix and suffix are trimmed. Generated files are small, so that is plenty;\n * a pair too large for the table falls back to \"every line replaced\", which is\n * still a correct (if larger) diff.\n */\n\n/** Lines of context around each change. */\nexport const DIFF_CONTEXT_LINES = 3;\n\n/** Above this many table cells the LCS falls back to a full replace. */\nconst MAX_LCS_CELLS = 4_000_000;\n\n/** A marker appended to the compare key of a last line without a newline. */\nconst NO_EOL = \"\\u0000no-eol\";\n\ntype Operation = { type: \" \" | \"-\" | \"+\"; key: string };\n\n/** Split text into compare keys: one per line, the last one marked when it has no newline. */\nfunction toLines(text: string): string[] {\n  if (text.length === 0) return [];\n\n  const lines = text.split(\"\\n\");\n  const endsWithNewline = lines[lines.length - 1] === \"\";\n\n  if (endsWithNewline) {\n    lines.pop();\n    return lines;\n  }\n\n  const last = lines.length - 1;\n\n  return lines.map((line, index) => (index === last ? `${line}${NO_EOL}` : line));\n}\n\n/** The edit script turning `before` into `after`. */\nfunction diffLines(before: readonly string[], after: readonly string[]): Operation[] {\n  let prefix = 0;\n\n  while (prefix < before.length && prefix < after.length && before[prefix] === after[prefix]) {\n    prefix++;\n  }\n\n  let suffix = 0;\n\n  while (\n    suffix < before.length - prefix &&\n    suffix < after.length - prefix &&\n    before[before.length - 1 - suffix] === after[after.length - 1 - suffix]\n  ) {\n    suffix++;\n  }\n\n  const head: Operation[] = before.slice(0, prefix).map((key) => ({ type: \" \", key }));\n  const tail: Operation[] = before.slice(before.length - suffix).map((key) => ({ type: \" \", key }));\n  const oldMiddle = before.slice(prefix, before.length - suffix);\n  const newMiddle = after.slice(prefix, after.length - suffix);\n\n  return [...head, ...diffMiddle(oldMiddle, newMiddle), ...tail];\n}\n\n/** LCS-based edit script for the part that differs. */\nfunction diffMiddle(before: readonly string[], after: readonly string[]): Operation[] {\n  const rows = before.length;\n  const columns = after.length;\n\n  if (rows === 0 || columns === 0 || (rows + 1) * (columns + 1) > MAX_LCS_CELLS) {\n    return [\n      ...before.map((key): Operation => ({ type: \"-\", key })),\n      ...after.map((key): Operation => ({ type: \"+\", key })),\n    ];\n  }\n\n  // table[i][j] = LCS length of before[i..] and after[j..], flattened.\n  const width = columns + 1;\n  const table = new Uint32Array((rows + 1) * width);\n\n  for (let i = rows - 1; i >= 0; i--) {\n    for (let j = columns - 1; j >= 0; j--) {\n      table[i * width + j] =\n        before[i] === after[j]\n          ? (table[(i + 1) * width + j + 1] ?? 0) + 1\n          : Math.max(table[(i + 1) * width + j] ?? 0, table[i * width + j + 1] ?? 0);\n    }\n  }\n\n  const operations: Operation[] = [];\n  let i = 0;\n  let j = 0;\n\n  while (i < rows && j < columns) {\n    const oldLine = before[i] ?? \"\";\n    const newLine = after[j] ?? \"\";\n\n    if (oldLine === newLine) {\n      operations.push({ type: \" \", key: oldLine });\n      i++;\n      j++;\n    } else if ((table[(i + 1) * width + j] ?? 0) >= (table[i * width + j + 1] ?? 0)) {\n      operations.push({ type: \"-\", key: oldLine });\n      i++;\n    } else {\n      operations.push({ type: \"+\", key: newLine });\n      j++;\n    }\n  }\n\n  for (; i < rows; i++) operations.push({ type: \"-\", key: before[i] ?? \"\" });\n  for (; j < columns; j++) operations.push({ type: \"+\", key: after[j] ?? \"\" });\n\n  return operations;\n}\n\nfunction renderLine(operation: Operation): string {\n  if (operation.key.endsWith(NO_EOL)) {\n    return `${operation.type}${operation.key.slice(0, -NO_EOL.length)}\\n\\\`;\n  }\n\n  return `${operation.type}${operation.key}`;\n}\n\n/** `start,count` of one side of a hunk header, GNU style (a zero count names the line before). */\nfunction range(start: number, count: number): string {\n  return `${count === 0 ? start : start + 1},${count}`;\n}\n\n/** Inputs of {@link unifiedDiff}. */\nexport type UnifiedDiffInput = {\n  /** Project-relative POSIX path, used in the headers. */\n  path: string;\n  /** The old content; `null` when the file is created. */\n  before: string | null;\n  /** The new content; `null` when the file is deleted. */\n  after: string | null;\n  /** Lines of context. Default {@link DIFF_CONTEXT_LINES}. */\n  context?: number;\n};\n\n/**\n * The unified diff between two versions of one file, or `\"\"` when they are\n * equal.\n *\n * @example\n * unifiedDiff({ path: \"src/app/users/routes.ts\", before: \"a\\n\", after: \"a\\nb\\n\" });\n * // --- a/src/app/users/routes.ts\n * // +++ b/src/app/users/routes.ts\n * // @@ -1,1 +1,2 @@\n * //  a\n * // +b\n */\nexport function unifiedDiff(input: UnifiedDiffInput): string {\n  const context = input.context ?? DIFF_CONTEXT_LINES;\n\n  if (input.before !== null && input.after !== null && input.before === input.after) return \"\";\n\n  const operations = diffLines(toLines(input.before ?? \"\"), toLines(input.after ?? \"\"));\n  const changes = operations.flatMap((operation, index) => (operation.type === \" \" ? [] : [index]));\n\n  const header = [\n    input.before === null ? \"--- /dev/null\" : `--- a/${input.path}`,\n    input.after === null ? \"+++ /dev/null\" : `+++ b/${input.path}`,\n  ];\n\n  if (changes.length === 0) {\n    // Same lines, different bytes the line split cannot see (only possible\n    // for an empty file created or deleted): headers alone still say it.\n    return `${header.join(\"\\n\")}\\n`;\n  }\n\n  const groups: { first: number; last: number }[] = [];\n\n  for (const index of changes) {\n    const current = groups[groups.length - 1];\n\n    if (current && index - current.last - 1 <= context * 2) {\n      current.last = index;\n    } else {\n      groups.push({ first: index, last: index });\n    }\n  }\n\n  const lines = [...header];\n\n  for (const group of groups) {\n    const from = Math.max(0, group.first - context);\n    const to = Math.min(operations.length - 1, group.last + context);\n    let oldStart = 0;\n    let newStart = 0;\n\n    for (let index = 0; index < from; index++) {\n      const type = operations[index]?.type;\n\n      if (type !== \"+\") oldStart++;\n      if (type !== \"-\") newStart++;\n    }\n\n    const slice = operations.slice(from, to + 1);\n    const oldCount = slice.filter((operation) => operation.type !== \"+\").length;\n    const newCount = slice.filter((operation) => operation.type !== \"-\").length;\n\n    lines.push(`@@ -${range(oldStart, oldCount)} +${range(newStart, newCount)} @@`);\n    lines.push(...slice.map(renderLine));\n  }\n\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"],"mappings":"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"}

package/esm/tooling/index.d.mts

@@ -0,0 +1,41 @@
+import { AGENTS_MD_END, AGENTS_MD_FILE, AGENTS_MD_START, upsertGeneratedSection } from "./agents-md/agents-md-markers.mjs";
+import { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, InspectConfigKey, InspectEvent, InspectJob, InspectModel, InspectModelColumn, InspectModelRelation, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema } from "./inspect/inspect-report.types.mjs";
+import { InstalledSkill, listInstalledSkills, parseSkillFrontMatter, shortSkillLine } from "./agents-md/installed-skills.mjs";
+import { AgentsMdWriteStatus, WriteAgentsMdOptions, WriteAgentsMdResult, writeAgentsMd } from "./agents-md/write-agents-md.mjs";
+import { AgentsMdRefresher, AgentsMdRefresherOptions, createAgentsMdRefresher } from "./agents-md/agents-md-refresher.mjs";
+import { RenderAgentsMdOptions, listAppModules, renderAgentsMdSection } from "./agents-md/render-agents-md.mjs";
+import { BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, BoardHistoryEntry, BoardInbox, BoardItem, BoardMessage, BoardState, BoardStatus, BoardVerdict, isBoardState, isBoardVerdict } from "./board/board.types.mjs";
+import { AddBoardItemInput, InitBoardResult, MoveBoardItemOptions, SendBoardMessageInput, SendBoardMessageResult, WatchBoardOptions, WatchBoardResult, addBoardItem, assertAgentName, assertBoardTransition, boardSlug, gitignoreCoversBoard, initBoard, listBoardItems, listBoardMessages, moveBoardItem, nextBoardStates, readBoardCursor, readBoardItem, readBoardStatus, sendBoardMessage, watchBoard, writeBoardCursor } from "./board/board.mjs";
+import { BoardMessageFields, ParsedBoardMessage, formatBoardMessage, parseBoardMessage } from "./board/board-message.mjs";
+import { ProblemInput, ProblemSource, ToolingProblem, createProblem } from "./problem.mjs";
+import { GitResult, GitRunner, listChangedFiles, runGit } from "./check/changed-files.mjs";
+import { CHECK_EXIT_CODES, CHECK_STEPS, CheckExitCode, CheckReport, CheckStep, CheckStepName, CheckStepStatus, checkExitCode } from "./check/check-report.types.mjs";
+import { checkFileConventions, checkTsconfigConventions, isAutoLoadedFile, runConventions } from "./check/conventions-step.mjs";
+import { MIN_NODE_VERSION, checkNodeVersion } from "./check/environment-step.mjs";
+import { LintOutcome, runLint } from "./check/lint-step.mjs";
+import { DEFAULT_TYPECHECK_BUILD_INFO, TypecheckOptions, TypecheckResult, diagnosticToProblem, directImporters, runTypecheck } from "./typecheck/run-typecheck.mjs";
+import { VitestRun, VitestRunner, findVitest, parseVitestReport, runVitest } from "./check/tests-step.mjs";
+import { CheckOptions, TypecheckRunner, runCheck } from "./check/run-check.mjs";
+import { RunTestsOptions, TestRunReport, runTests, testRunArguments } from "./check/run-tests.mjs";
+import { DEV_SERVER_STATE_FILE, DevServerState, parseDevServerState, readDevServerState, removeDevServerState, updateDevServerState, writeDevServerState } from "./dev-state/dev-server-state.mjs";
+import { ConnectDevtoolsOptions, DEFAULT_DEVTOOLS_PATH, DevtoolsClient, DevtoolsEndpoint, DevtoolsFetch, DevtoolsPhaseRecord, DevtoolsRequestRecord, DevtoolsRequestSummaryRecord, connectDevtools, parseRequestRecord, parseRequestSummary, resolveDevServerEndpoint } from "./devtools/devtools-client.mjs";
+import { GeneratorArgsOptions, GeneratorSpec, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MakeGenerator, buildGeneratorArgs, isMakeGenerator } from "./generate/generator-spec.mjs";
+import { CliInvocation, CliRun, CliRunner, DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli } from "./generate/run-cli.mjs";
+import { ApplyGenerationOptions, GeneratedFile, GenerationBackend, GenerationPlan, GenerationPlanOptions, MAX_FILE_DIFF_BYTES, SandboxBackendOptions, applyGeneration, sandboxBackend } from "./generate/generation.mjs";
+import { DIFF_CONTEXT_LINES, UnifiedDiffInput, unifiedDiff } from "./generate/unified-diff.mjs";
+import { EventRecorder, RecordedListener, groupListeners } from "./inspect/event-recorder.mjs";
+import { InspectModelModule } from "./inspect/collect-models.mjs";
+import { AppModuleImporter } from "./inspect/collect-packages.mjs";
+import { InspectOptions, inspectApp, isInspectSection, parseInspectSections } from "./inspect/inspect-app.mjs";
+import { InspectBootResult, bootForInspect, inspectOptionsFromBoot } from "./inspect/boot-for-inspect.mjs";
+import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect/inspect-report.schema.mjs";
+import { DbSchema, DbSchemaColumn, DbSchemaTable, buildDbSchema } from "./mcp/db-schema.mjs";
+import { DOCS_CORPUS_GLOBS, DocsCorpus, DocsSearchHit, DocsSection, loadDocsCorpus, readDocsFile, searchDocs, searchTerms, splitSections } from "./mcp/docs-search.mjs";
+import { McpInputProperty, McpInputSchema, inputSchema, toStandardSchema, validateToolInput } from "./mcp/tool-input.mjs";
+import { MCP_MAKE_GENERATORS, WarlockMcpContext, WarlockMcpTool, createWarlockMcpTools, describeToolError, makeSpecFromInput } from "./mcp/mcp-tools.mjs";
+import { CreateMcpContextOptions, createMcpContext } from "./mcp/create-mcp-context.mjs";
+import { AiToolsServeModule, MCP_INSTALL_HINT, ServeToolContract, isAiToolsServeModule, loadAiToolsServe } from "./mcp/load-ai-tools.mjs";
+import { StartWarlockMcpServerOptions, WarlockMcpServerHandle, WarlockMcpTransport, isLoopbackHost, resolveMcpTransport, startWarlockMcpServer, toServeContract } from "./mcp/start-mcp-server.mjs";
+import { TRACE_SCHEMA_VERSION, TraceMiddleware, TraceQuery, TraceReport, TraceValidation } from "./trace/trace-report.types.mjs";
+import { BuildTraceReportInput, TRACE_BODY_LIMIT, TRACE_REQUEST_ID_HEADER, TraceRequestOptions, TracedResponse, buildTraceReport, readResponseBody, redactHeaders, resolveTraceUrl, traceRequest } from "./trace/trace-request.mjs";
+export { AGENTS_MD_END, AGENTS_MD_FILE, AGENTS_MD_START, type AddBoardItemInput, type AgentsMdRefresher, type AgentsMdRefresherOptions, type AgentsMdWriteStatus, type AiToolsServeModule, type AppModuleImporter, type ApplyGenerationOptions, BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, type BoardHistoryEntry, type BoardInbox, type BoardItem, type BoardMessage, type BoardMessageFields, type BoardState, type BoardStatus, type BoardVerdict, type BuildTraceReportInput, CHECK_EXIT_CODES, CHECK_STEPS, type CheckExitCode, type CheckOptions, type CheckReport, type CheckStep, type CheckStepName, type CheckStepStatus, type CliInvocation, type CliRun, type CliRunner, ConnectDevtoolsOptions, type CreateMcpContextOptions, DEFAULT_DEVTOOLS_PATH, DEFAULT_GENERATION_TIMEOUT_MS, DEFAULT_TYPECHECK_BUILD_INFO, DEV_SERVER_STATE_FILE, DIFF_CONTEXT_LINES, DOCS_CORPUS_GLOBS, type DbSchema, type DbSchemaColumn, type DbSchemaTable, DevServerState, DevtoolsClient, DevtoolsEndpoint, DevtoolsFetch, DevtoolsPhaseRecord, DevtoolsRequestRecord, DevtoolsRequestSummaryRecord, type DocsCorpus, type DocsSearchHit, type DocsSection, EventRecorder, type GeneratedFile, type GenerationBackend, type GenerationPlan, type GenerationPlanOptions, type GeneratorArgsOptions, type GeneratorSpec, type GitResult, type GitRunner, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, type InitBoardResult, type InspectBootResult, InspectConfigKey, InspectEvent, InspectJob, InspectModel, InspectModelColumn, type InspectModelModule, InspectModelRelation, type InspectOptions, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, type InstalledSkill, JsonSchema, type LintOutcome, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MAX_FILE_DIFF_BYTES, MCP_INSTALL_HINT, MCP_MAKE_GENERATORS, MIN_NODE_VERSION, type MakeGenerator, type McpInputProperty, type McpInputSchema, type MoveBoardItemOptions, type ParsedBoardMessage, type ProblemInput, type ProblemSource, type RecordedListener, type RenderAgentsMdOptions, type RunTestsOptions, type SandboxBackendOptions, type SendBoardMessageInput, type SendBoardMessageResult, type ServeToolContract, type StartWarlockMcpServerOptions, TRACE_BODY_LIMIT, TRACE_REQUEST_ID_HEADER, TRACE_SCHEMA_VERSION, type TestRunReport, type ToolingProblem, TraceMiddleware, TraceQuery, TraceReport, type TraceRequestOptions, TraceValidation, type TracedResponse, type TypecheckOptions, type TypecheckResult, type TypecheckRunner, type UnifiedDiffInput, type VitestRun, type VitestRunner, type WarlockMcpContext, type WarlockMcpServerHandle, type WarlockMcpTool, type WarlockMcpTransport, type WatchBoardOptions, type WatchBoardResult, type WriteAgentsMdOptions, type WriteAgentsMdResult, addBoardItem, applyGeneration, assertAgentName, assertBoardTransition, boardSlug, bootForInspect, buildDbSchema, buildGeneratorArgs, buildTraceReport, checkExitCode, checkFileConventions, checkNodeVersion, checkTsconfigConventions, connectDevtools, createAgentsMdRefresher, createMcpContext, createProblem, createWarlockMcpTools, describeRun, describeToolError, diagnosticToProblem, directImporters, findVitest, formatBoardMessage, gitignoreCoversBoard, groupListeners, initBoard, inputSchema, inspectApp, inspectOptionsFromBoot, isAiToolsServeModule, isAutoLoadedFile, isBoardState, isBoardVerdict, isInspectSection, isLoopbackHost, isMakeGenerator, listAppModules, listBoardItems, listBoardMessages, listChangedFiles, listInstalledSkills, loadAiToolsServe, loadDocsCorpus, makeSpecFromInput, moveBoardItem, nextBoardStates, parseBoardMessage, parseDevServerState, parseInspectSections, parseRequestRecord, parseRequestSummary, parseSkillFrontMatter, parseVitestReport, readBoardCursor, readBoardItem, readBoardStatus, readDevServerState, readDocsFile, readResponseBody, redactHeaders, removeDevServerState, renderAgentsMdSection, resolveCliEntry, resolveDevServerEndpoint, resolveMcpTransport, resolveTraceUrl, runCheck, runConventions, runGit, runLint, runTests, runTypecheck, runVitest, sandboxBackend, searchDocs, searchTerms, sendBoardMessage, shortSkillLine, spawnCli, splitSections, startWarlockMcpServer, testRunArguments, toServeContract, toStandardSchema, traceRequest, unifiedDiff, updateDevServerState, upsertGeneratedSection, validateToolInput, watchBoard, writeAgentsMd, writeBoardCursor, writeDevServerState };

package/esm/tooling/index.mjs

@@ -0,0 +1,45 @@
+import { AGENTS_MD_END, AGENTS_MD_FILE, AGENTS_MD_START, upsertGeneratedSection } from "./agents-md/agents-md-markers.mjs";
+import { listInstalledSkills, parseSkillFrontMatter, shortSkillLine } from "./agents-md/installed-skills.mjs";
+import { listAppModules, renderAgentsMdSection } from "./agents-md/render-agents-md.mjs";
+import { writeAgentsMd } from "./agents-md/write-agents-md.mjs";
+import { EventRecorder, groupListeners } from "./inspect/event-recorder.mjs";
+import { bootForInspect, inspectOptionsFromBoot } from "./inspect/boot-for-inspect.mjs";
+import { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS } from "./inspect/inspect-report.types.mjs";
+import { inspectApp, isInspectSection, parseInspectSections } from "./inspect/inspect-app.mjs";
+import { BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, isBoardState, isBoardVerdict } from "./board/board.types.mjs";
+import { formatBoardMessage, parseBoardMessage } from "./board/board-message.mjs";
+import { addBoardItem, assertAgentName, assertBoardTransition, boardSlug, gitignoreCoversBoard, initBoard, listBoardItems, listBoardMessages, moveBoardItem, nextBoardStates, readBoardCursor, readBoardItem, readBoardStatus, sendBoardMessage, watchBoard, writeBoardCursor } from "./board/board.mjs";
+import { CHECK_EXIT_CODES, CHECK_STEPS, checkExitCode } from "./check/check-report.types.mjs";
+import { createProblem } from "./problem.mjs";
+import { DEFAULT_TYPECHECK_BUILD_INFO, diagnosticToProblem, directImporters, runTypecheck } from "./typecheck/run-typecheck.mjs";
+import { listChangedFiles, runGit } from "./check/changed-files.mjs";
+import { checkFileConventions, checkTsconfigConventions, isAutoLoadedFile, runConventions } from "./check/conventions-step.mjs";
+import { MIN_NODE_VERSION, checkNodeVersion } from "./check/environment-step.mjs";
+import { runLint } from "./check/lint-step.mjs";
+import { findVitest, parseVitestReport, runVitest } from "./check/tests-step.mjs";
+import { runCheck } from "./check/run-check.mjs";
+import { DEV_SERVER_STATE_FILE, parseDevServerState, readDevServerState, removeDevServerState, updateDevServerState, writeDevServerState } from "./dev-state/dev-server-state.mjs";
+import { DEFAULT_DEVTOOLS_PATH, connectDevtools, parseRequestRecord, parseRequestSummary, resolveDevServerEndpoint } from "./devtools/devtools-client.mjs";
+import { runTests, testRunArguments } from "./check/run-tests.mjs";
+import { MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, buildGeneratorArgs, isMakeGenerator } from "./generate/generator-spec.mjs";
+import { DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli } from "./generate/run-cli.mjs";
+import { DIFF_CONTEXT_LINES, unifiedDiff } from "./generate/unified-diff.mjs";
+import { MAX_FILE_DIFF_BYTES, applyGeneration, sandboxBackend } from "./generate/generation.mjs";
+import "./generate/index.mjs";
+import { DOCS_CORPUS_GLOBS, loadDocsCorpus, readDocsFile, searchDocs, searchTerms, splitSections } from "./mcp/docs-search.mjs";
+import { createMcpContext } from "./mcp/create-mcp-context.mjs";
+import { MCP_INSTALL_HINT, isAiToolsServeModule, loadAiToolsServe } from "./mcp/load-ai-tools.mjs";
+import { buildDbSchema } from "./mcp/db-schema.mjs";
+import { inputSchema, toStandardSchema, validateToolInput } from "./mcp/tool-input.mjs";
+import { MCP_MAKE_GENERATORS, createWarlockMcpTools, describeToolError, makeSpecFromInput } from "./mcp/mcp-tools.mjs";
+import { isLoopbackHost, resolveMcpTransport, startWarlockMcpServer, toServeContract } from "./mcp/start-mcp-server.mjs";
+import { TRACE_SCHEMA_VERSION } from "./trace/trace-report.types.mjs";
+import { TRACE_BODY_LIMIT, TRACE_REQUEST_ID_HEADER, buildTraceReport, readResponseBody, redactHeaders, resolveTraceUrl, traceRequest } from "./trace/trace-request.mjs";
+import { createAgentsMdRefresher } from "./agents-md/agents-md-refresher.mjs";
+import "./check/index.mjs";
+import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect/inspect-report.schema.mjs";
+import "./inspect/index.mjs";
+import "./mcp/index.mjs";
+import "./typecheck/index.mjs";
+
+export { AGENTS_MD_END, AGENTS_MD_FILE, AGENTS_MD_START, BOARD_DIRECTORY, BOARD_STATES, BOARD_TRANSITIONS, BOARD_VERDICT_LINES, CHECK_EXIT_CODES, CHECK_STEPS, DEFAULT_DEVTOOLS_PATH, DEFAULT_GENERATION_TIMEOUT_MS, DEFAULT_TYPECHECK_BUILD_INFO, DEV_SERVER_STATE_FILE, DIFF_CONTEXT_LINES, DOCS_CORPUS_GLOBS, EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MAX_FILE_DIFF_BYTES, MCP_INSTALL_HINT, MCP_MAKE_GENERATORS, MIN_NODE_VERSION, TRACE_BODY_LIMIT, TRACE_REQUEST_ID_HEADER, TRACE_SCHEMA_VERSION, addBoardItem, applyGeneration, assertAgentName, assertBoardTransition, boardSlug, bootForInspect, buildDbSchema, buildGeneratorArgs, buildTraceReport, checkExitCode, checkFileConventions, checkNodeVersion, checkTsconfigConventions, connectDevtools, createAgentsMdRefresher, createMcpContext, createProblem, createWarlockMcpTools, describeRun, describeToolError, diagnosticToProblem, directImporters, findVitest, formatBoardMessage, gitignoreCoversBoard, groupListeners, initBoard, inputSchema, inspectApp, inspectOptionsFromBoot, isAiToolsServeModule, isAutoLoadedFile, isBoardState, isBoardVerdict, isInspectSection, isLoopbackHost, isMakeGenerator, listAppModules, listBoardItems, listBoardMessages, listChangedFiles, listInstalledSkills, loadAiToolsServe, loadDocsCorpus, makeSpecFromInput, moveBoardItem, nextBoardStates, parseBoardMessage, parseDevServerState, parseInspectSections, parseRequestRecord, parseRequestSummary, parseSkillFrontMatter, parseVitestReport, readBoardCursor, readBoardItem, readBoardStatus, readDevServerState, readDocsFile, readResponseBody, redactHeaders, removeDevServerState, renderAgentsMdSection, resolveCliEntry, resolveDevServerEndpoint, resolveMcpTransport, resolveTraceUrl, runCheck, runConventions, runGit, runLint, runTests, runTypecheck, runVitest, sandboxBackend, searchDocs, searchTerms, sendBoardMessage, shortSkillLine, spawnCli, splitSections, startWarlockMcpServer, testRunArguments, toServeContract, toStandardSchema, traceRequest, unifiedDiff, updateDevServerState, upsertGeneratedSection, validateToolInput, watchBoard, writeAgentsMd, writeBoardCursor, writeDevServerState };

package/esm/tooling/inspect/boot-for-inspect.d.mts

@@ -0,0 +1,23 @@
+import { DoctorBootContext } from "../../cli/commands/doctor/check.types.mjs";
+import { RecordedListener } from "./event-recorder.mjs";
+import { InspectOptions } from "./inspect-app.mjs";
+
+//#region ../../packages/core/src/tooling/inspect/boot-for-inspect.d.ts
+/** What the boot pass observed, ready to hand to `inspectApp`. */
+type InspectBootResult = {
+  context: DoctorBootContext;
+  events: RecordedListener[]; /** Names resource classes by the export of their `*.resource.ts` module. */
+  resolveResourceName: (resource: unknown) => string | undefined; /** Resource modules that could not be read while naming resources. */
+  warnings: string[];
+};
+/**
+ * Boot the app the way `warlock doctor` does — every connector booted, none
+ * started, no connection opened and no port bound — while recording the event
+ * listeners app modules register.
+ */
+declare function bootForInspect(cwd?: string): Promise<InspectBootResult>;
+/** The `inspectApp` inputs a boot pass provides. */
+declare function inspectOptionsFromBoot(result: InspectBootResult): InspectOptions;
+//#endregion
+export { InspectBootResult, bootForInspect, inspectOptionsFromBoot };
+//# sourceMappingURL=boot-for-inspect.d.mts.map

package/esm/tooling/inspect/boot-for-inspect.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-for-inspect.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/boot-for-inspect.ts"],"mappings":";;;;;;KAYY,iBAAA;EACV,OAAA,EAAS,iBAAA;EACT,MAAA,EAAQ,gBAAgB;EAExB,mBAAA,GAAsB,QAAA,kCAHtB;EAKA,QAAA;AAAA;;;;;;iBAyBoB,cAAA,CAAe,GAAA,YAAsB,OAAO,CAAC,iBAAA;AAAnE;AAAA,iBAyBgB,sBAAA,CAAuB,MAAA,EAAQ,iBAAA,GAAoB,cAAc"}

package/esm/tooling/inspect/boot-for-inspect.mjs

@@ -0,0 +1,63 @@
+import { filesOrchestrator } from "../../dev-server/files-orchestrator.mjs";
+import { bootForDiagnostics } from "../../cli/commands/doctor/boot-for-diagnostics.mjs";
+import { collectResourceExportMap } from "../../router/named-api-routes-with-responses.mjs";
+import { EventRecorder } from "./event-recorder.mjs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import events from "@mongez/events";
+import { resolve as resolve$1 } from "import-meta-resolve";
+
+//#region ../../packages/core/src/tooling/inspect/boot-for-inspect.ts
+/**
+* The app's own `@mongez/events` instance, when it resolves to a different
+* module than core's (two installed copies). `undefined` otherwise.
+*/
+async function appEventBus(cwd) {
+	try {
+		const module = await import(resolve$1("@mongez/events", pathToFileURL(path.join(cwd, "package.json")).href));
+		return typeof module === "object" && module !== null ? Reflect.get(module, "default") : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Boot the app the way `warlock doctor` does — every connector booted, none
+* started, no connection opened and no port bound — while recording the event
+* listeners app modules register.
+*/
+async function bootForInspect(cwd = process.cwd()) {
+	const recorder = new EventRecorder().start([events, await appEventBus(cwd)]);
+	try {
+		const context = await bootForDiagnostics();
+		const warnings = [];
+		const resources = context.booted ? await collectResourceExportMap(filesOrchestrator.getFiles().values(), (message) => {
+			warnings.push(message);
+		}) : /* @__PURE__ */ new Map();
+		return {
+			context,
+			events: recorder.list(),
+			resolveResourceName: (resource) => resources.get(resource)?.exportName,
+			warnings
+		};
+	} finally {
+		recorder.stop();
+	}
+}
+/** The `inspectApp` inputs a boot pass provides. */
+function inspectOptionsFromBoot(result) {
+	return {
+		modelModules: result.context.modelModules,
+		moduleFailures: result.context.moduleFailures,
+		events: result.events,
+		resolveResourceName: result.resolveResourceName,
+		warnings: result.warnings.map((message) => ({
+			code: null,
+			message,
+			source: "resources"
+		}))
+	};
+}
+
+//#endregion
+export { bootForInspect, inspectOptionsFromBoot };
+//# sourceMappingURL=boot-for-inspect.mjs.map

package/esm/tooling/inspect/boot-for-inspect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-for-inspect.mjs","names":["resolveModule"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/boot-for-inspect.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolve as resolveModule } from \"import-meta-resolve\";\nimport { bootForDiagnostics } from \"../../cli/commands/doctor/boot-for-diagnostics\";\nimport type { DoctorBootContext } from \"../../cli/commands/doctor/check.types\";\nimport { filesOrchestrator } from \"../../dev-server/files-orchestrator\";\nimport { collectResourceExportMap } from \"../../router/named-api-routes-with-responses\";\nimport { EventRecorder, type RecordedListener } from \"./event-recorder\";\nimport type { InspectOptions } from \"./inspect-app\";\n\n/** What the boot pass observed, ready to hand to `inspectApp`. */\nexport type InspectBootResult = {\n  context: DoctorBootContext;\n  events: RecordedListener[];\n  /** Names resource classes by the export of their `*.resource.ts` module. */\n  resolveResourceName: (resource: unknown) => string | undefined;\n  /** Resource modules that could not be read while naming resources. */\n  warnings: string[];\n};\n\n/**\n * The app's own `@mongez/events` instance, when it resolves to a different\n * module than core's (two installed copies). `undefined` otherwise.\n */\nasync function appEventBus(cwd: string): Promise<unknown> {\n  try {\n    const url = resolveModule(\"@mongez/events\", pathToFileURL(path.join(cwd, \"package.json\")).href);\n    const module: unknown = await import(url);\n\n    return typeof module === \"object\" && module !== null\n      ? Reflect.get(module, \"default\")\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Boot the app the way `warlock doctor` does — every connector booted, none\n * started, no connection opened and no port bound — while recording the event\n * listeners app modules register.\n */\nexport async function bootForInspect(cwd = process.cwd()): Promise<InspectBootResult> {\n  const recorder = new EventRecorder().start([events, await appEventBus(cwd)]);\n\n  try {\n    const context = await bootForDiagnostics();\n    const warnings: string[] = [];\n    // The same export map `generate.openapi` names resources with.\n    const resources = context.booted\n      ? await collectResourceExportMap(filesOrchestrator.getFiles().values(), (message) => {\n          warnings.push(message);\n        })\n      : new Map<unknown, { exportName: string }>();\n\n    return {\n      context,\n      events: recorder.list(),\n      resolveResourceName: (resource) => resources.get(resource)?.exportName,\n      warnings,\n    };\n  } finally {\n    recorder.stop();\n  }\n}\n\n/** The `inspectApp` inputs a boot pass provides. */\nexport function inspectOptionsFromBoot(result: InspectBootResult): InspectOptions {\n  return {\n    modelModules: result.context.modelModules,\n    moduleFailures: result.context.moduleFailures,\n    events: result.events,\n    resolveResourceName: result.resolveResourceName,\n    warnings: result.warnings.map((message) => ({ code: null, message, source: \"resources\" })),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAyBA,eAAe,YAAY,KAA+B;CACxD,IAAI;EAEF,MAAM,SAAkB,MAAM,OADlBA,UAAc,kBAAkB,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,IACnD;EAEvC,OAAO,OAAO,WAAW,YAAY,WAAW,OAC5C,QAAQ,IAAI,QAAQ,SAAS,IAC7B;CACN,QAAQ;EACN;CACF;AACF;;;;;;AAOA,eAAsB,eAAe,MAAM,QAAQ,IAAI,GAA+B;CACpF,MAAM,WAAW,IAAI,cAAc,CAAC,CAAC,MAAM,CAAC,QAAQ,MAAM,YAAY,GAAG,CAAC,CAAC;CAE3E,IAAI;EACF,MAAM,UAAU,MAAM,mBAAmB;EACzC,MAAM,WAAqB,CAAC;EAE5B,MAAM,YAAY,QAAQ,SACtB,MAAM,yBAAyB,kBAAkB,SAAS,CAAC,CAAC,OAAO,IAAI,YAAY;GACjF,SAAS,KAAK,OAAO;EACvB,CAAC,oBACD,IAAI,IAAqC;EAE7C,OAAO;GACL;GACA,QAAQ,SAAS,KAAK;GACtB,sBAAsB,aAAa,UAAU,IAAI,QAAQ,CAAC,EAAE;GAC5D;EACF;CACF,UAAU;EACR,SAAS,KAAK;CAChB;AACF;;AAGA,SAAgB,uBAAuB,QAA2C;CAChF,OAAO;EACL,cAAc,OAAO,QAAQ;EAC7B,gBAAgB,OAAO,QAAQ;EAC/B,QAAQ,OAAO;EACf,qBAAqB,OAAO;EAC5B,UAAU,OAAO,SAAS,KAAK,aAAa;GAAE,MAAM;GAAM;GAAS,QAAQ;EAAY,EAAE;CAC3F;AACF"}

package/esm/tooling/inspect/collect-config.mjs

@@ -0,0 +1,77 @@
+import config from "@mongez/config";
+import path from "node:path";
+import { existsSync } from "node:fs";
+
+//#region ../../packages/core/src/tooling/inspect/collect-config.ts
+/** How deep nested config objects are walked. Deeper keys are reported as `object`. */
+const MAX_DEPTH = 4;
+/** Extensions a `src/config/<name>` file may have. */
+const CONFIG_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".js",
+	".mjs"
+];
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+/** The JS type of a config value, without the value. */
+function configValueType(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "array";
+	if (value instanceof RegExp) return "regexp";
+	if (value instanceof Date) return "date";
+	if (isPlainObject(value)) return "object";
+	if (typeof value === "object") {
+		const constructorName = Reflect.get(Object.getPrototypeOf(value) ?? {}, "constructor");
+		return typeof constructorName === "function" && constructorName.name ? constructorName.name : "object";
+	}
+	return typeof value;
+}
+function configFileFor(cwd, section) {
+	for (const extension of CONFIG_EXTENSIONS) {
+		const relative = `src/config/${section}${extension}`;
+		if (existsSync(path.join(cwd, relative))) return relative;
+	}
+	return null;
+}
+/**
+* Every loaded config key as a dotted path with its type — NEVER its value,
+* because config holds secrets. Plain objects are walked up to
+* {@link MAX_DEPTH} levels; arrays, class instances and functions are leaves.
+*
+* @param cwd Project root, used to name the `src/config/*` file of each section.
+* @param source The loaded config tree; defaults to everything `config` holds.
+*/
+function collectConfig(cwd, source) {
+	const tree = source ?? config.list();
+	const keys = [];
+	if (!isPlainObject(tree)) return keys;
+	const walk = (value, prefix, depth, file) => {
+		if (isPlainObject(value) && depth < MAX_DEPTH && Object.keys(value).length > 0) {
+			for (const [key, child] of Object.entries(value)) walk(child, `${prefix}.${key}`, depth + 1, file);
+			return;
+		}
+		keys.push({
+			key: prefix,
+			type: configValueType(value),
+			file
+		});
+	};
+	for (const [section, value] of Object.entries(tree)) {
+		const file = configFileFor(cwd, section);
+		if (isPlainObject(value) && Object.keys(value).length > 0) for (const [key, child] of Object.entries(value)) walk(child, `${section}.${key}`, 2, file);
+		else keys.push({
+			key: section,
+			type: configValueType(value),
+			file
+		});
+	}
+	return keys.sort((first, second) => first.key.localeCompare(second.key));
+}
+
+//#endregion
+export { collectConfig };
+//# sourceMappingURL=collect-config.mjs.map

package/esm/tooling/inspect/collect-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-config.mjs","names":["baseConfig"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-config.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectConfigKey } from \"./inspect-report.types\";\n\n/** How deep nested config objects are walked. Deeper keys are reported as `object`. */\nconst MAX_DEPTH = 4;\n\n/** Extensions a `src/config/<name>` file may have. */\nconst CONFIG_EXTENSIONS = [\".ts\", \".tsx\", \".js\", \".mjs\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\n/** The JS type of a config value, without the value. */\nexport function configValueType(value: unknown): string {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  if (value instanceof RegExp) return \"regexp\";\n  if (value instanceof Date) return \"date\";\n  if (isPlainObject(value)) return \"object\";\n\n  if (typeof value === \"object\") {\n    const constructorName = Reflect.get(Object.getPrototypeOf(value) ?? {}, \"constructor\");\n\n    return typeof constructorName === \"function\" && constructorName.name\n      ? constructorName.name\n      : \"object\";\n  }\n\n  return typeof value;\n}\n\nfunction configFileFor(cwd: string, section: string): string | null {\n  for (const extension of CONFIG_EXTENSIONS) {\n    const relative = `src/config/${section}${extension}`;\n\n    if (existsSync(path.join(cwd, relative))) return relative;\n  }\n\n  return null;\n}\n\n/**\n * Every loaded config key as a dotted path with its type — NEVER its value,\n * because config holds secrets. Plain objects are walked up to\n * {@link MAX_DEPTH} levels; arrays, class instances and functions are leaves.\n *\n * @param cwd Project root, used to name the `src/config/*` file of each section.\n * @param source The loaded config tree; defaults to everything `config` holds.\n */\nexport function collectConfig(cwd: string, source?: Record<string, unknown>): InspectConfigKey[] {\n  const tree: unknown = source ?? baseConfig.list();\n  const keys: InspectConfigKey[] = [];\n\n  if (!isPlainObject(tree)) return keys;\n\n  const walk = (value: unknown, prefix: string, depth: number, file: string | null) => {\n    if (isPlainObject(value) && depth < MAX_DEPTH && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${prefix}.${key}`, depth + 1, file);\n      }\n\n      return;\n    }\n\n    keys.push({ key: prefix, type: configValueType(value), file });\n  };\n\n  for (const [section, value] of Object.entries(tree)) {\n    const file = configFileFor(cwd, section);\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${section}.${key}`, 2, file);\n      }\n    } else {\n      keys.push({ key: section, type: configValueType(value), file });\n    }\n  }\n\n  return keys.sort((first, second) => first.key.localeCompare(second.key));\n}\n"],"mappings":";;;;;;AAMA,MAAM,YAAY;;AAGlB,MAAM,oBAAoB;CAAC;CAAO;CAAQ;CAAO;AAAM;AAEvD,SAAS,cAAc,OAAkD;CACvE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,YAAY,OAAO,eAAe,KAAK;CAE7C,OAAO,cAAc,OAAO,aAAa,cAAc;AACzD;;AAGA,SAAgB,gBAAgB,OAAwB;CACtD,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO;CACjC,IAAI,iBAAiB,QAAQ,OAAO;CACpC,IAAI,iBAAiB,MAAM,OAAO;CAClC,IAAI,cAAc,KAAK,GAAG,OAAO;CAEjC,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,kBAAkB,QAAQ,IAAI,OAAO,eAAe,KAAK,KAAK,CAAC,GAAG,aAAa;EAErF,OAAO,OAAO,oBAAoB,cAAc,gBAAgB,OAC5D,gBAAgB,OAChB;CACN;CAEA,OAAO,OAAO;AAChB;AAEA,SAAS,cAAc,KAAa,SAAgC;CAClE,KAAK,MAAM,aAAa,mBAAmB;EACzC,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,WAAW,KAAK,KAAK,KAAK,QAAQ,CAAC,GAAG,OAAO;CACnD;CAEA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,cAAc,KAAa,QAAsD;CAC/F,MAAM,OAAgB,UAAUA,OAAW,KAAK;CAChD,MAAM,OAA2B,CAAC;CAElC,IAAI,CAAC,cAAc,IAAI,GAAG,OAAO;CAEjC,MAAM,QAAQ,OAAgB,QAAgB,OAAe,SAAwB;EACnF,IAAI,cAAc,KAAK,KAAK,QAAQ,aAAa,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GAAG;GAC9E,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,OAAO,GAAG,OAAO,QAAQ,GAAG,IAAI;GAGjD;EACF;EAEA,KAAK,KAAK;GAAE,KAAK;GAAQ,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAC/D;CAEA,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,IAAI,GAAG;EACnD,MAAM,OAAO,cAAc,KAAK,OAAO;EAEvC,IAAI,cAAc,KAAK,KAAK,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACtD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI;OAG1C,KAAK,KAAK;GAAE,KAAK;GAAS,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAElE;CAEA,OAAO,KAAK,MAAM,OAAO,WAAW,MAAM,IAAI,cAAc,OAAO,GAAG,CAAC;AACzE"}

package/esm/tooling/inspect/collect-models.d.mts

@@ -0,0 +1,9 @@
+//#region ../../packages/core/src/tooling/inspect/collect-models.d.ts
+/** A model module the boot pass imported: its file and its exports. */
+type InspectModelModule = {
+  /** Project-relative path. */file: string;
+  exports: Record<string, unknown>;
+};
+//#endregion
+export { InspectModelModule };
+//# sourceMappingURL=collect-models.d.mts.map

package/esm/tooling/inspect/collect-models.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-models.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-models.ts"],"mappings":";;KAaY,kBAAA;EAAkB,6BAE5B,IAAA;EACA,OAAA,EAAS,MAAM;AAAA"}