@warlock.js/core 5.34.3 → 5.35.0

package/esm/tooling/index.d.mts

@@ -1,5 +1,5 @@
 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 { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, InspectConfigKey, InspectEvent, InspectFile, 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";
@@ -7,9 +7,11 @@ import { RenderAgentsMdOptions, listAppModules, renderAgentsMdSection } from "./
 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 { ProblemFix } from "./check/fixes.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 { ConventionOptions } from "./check/web-conventions.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";
@@ -17,6 +19,8 @@ import { DEFAULT_TYPECHECK_BUILD_INFO, TypecheckOptions, TypecheckResult, diagno
 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 { affectedFiles } from "./check/affected-files.mjs";
+import "./check/index.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";
@@ -29,6 +33,7 @@ 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 { ExplainedFile, explainFile } from "./inspect/explain-file.mjs";
 import "./inspect/index.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";
@@ -39,4 +44,4 @@ import { AiToolsServeModule, MCP_INSTALL_HINT, ServeToolContract, isAiToolsServe
 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 };
+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 ConventionOptions, 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 ExplainedFile, 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, InspectFile, 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 ProblemFix, 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, affectedFiles, applyGeneration, assertAgentName, assertBoardTransition, boardSlug, bootForInspect, buildDbSchema, buildGeneratorArgs, buildTraceReport, checkExitCode, checkFileConventions, checkNodeVersion, checkTsconfigConventions, connectDevtools, createAgentsMdRefresher, createMcpContext, createProblem, createWarlockMcpTools, describeRun, describeToolError, diagnosticToProblem, directImporters, explainFile, 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

@@ -11,15 +11,17 @@ 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 { checkFileConventions, checkTsconfigConventions, isAutoLoadedFile, runConventions } from "./check/conventions-step.mjs";
+import { affectedFiles } from "./check/affected-files.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 { explainFile } from "./inspect/explain-file.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";
@@ -42,4 +44,4 @@ 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 };
+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, affectedFiles, applyGeneration, assertAgentName, assertBoardTransition, boardSlug, bootForInspect, buildDbSchema, buildGeneratorArgs, buildTraceReport, checkExitCode, checkFileConventions, checkNodeVersion, checkTsconfigConventions, connectDevtools, createAgentsMdRefresher, createMcpContext, createProblem, createWarlockMcpTools, describeRun, describeToolError, diagnosticToProblem, directImporters, explainFile, 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/collect-files.mjs

@@ -0,0 +1,172 @@
+import { isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile, isWorkerFile } from "../../dev-server/special-file-patterns.mjs";
+import { forEachChild } from "../syntax/ast.mjs";
+import path from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { readTsconfig, resolvePathAlias } from "get-tsconfig";
+import { parseSync } from "oxc-parser";
+
+//#region ../../packages/core/src/tooling/inspect/collect-files.ts
+const CODE = /\.(?:[cm]?[jt]s|[jt]sx)$/;
+const EXTENSIONS = [
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+	".d.ts"
+];
+function projectFile(cwd, file) {
+	return path.relative(cwd, path.resolve(cwd, file)).split(path.sep).join("/");
+}
+/** Infer a role from file names and the framework's directory conventions. */
+function fileRole(file) {
+	const stem = path.posix.basename(file).replace(CODE, "");
+	if (/(?:^|\.)(?:spec|test)$/.test(stem)) return "spec";
+	if (file.endsWith(".d.ts")) return "type";
+	if (isConfigFile(file)) return "config";
+	if (isRouteFile(file)) return "routes";
+	if (isMainFile(file)) return "main";
+	if (isWorkerFile(file)) return "worker";
+	if (isEventFile(file)) return "event";
+	if (isLocaleFile(file)) return "locale";
+	for (const role of [
+		"routes",
+		"page",
+		"setup",
+		"layout",
+		"root"
+	]) if (stem === role || stem.endsWith(`.${role}`)) return role;
+	for (const role of [
+		"controller",
+		"service",
+		"repository",
+		"model",
+		"migration",
+		"schema",
+		"resource",
+		"hook",
+		"component",
+		"util",
+		"type",
+		"config"
+	]) if (stem.endsWith(`.${role}`) || file.split("/").includes(role === "repository" ? "repositories" : `${role}s`)) return role;
+	if (file.startsWith("src/config/")) return "config";
+	if (file.split("/").includes("utils")) return "util";
+	if (/^use[A-Z]/.test(stem)) return "hook";
+	if (/\.tsx$|\.jsx$/.test(file)) return "component";
+	return "source";
+}
+function bindingNames(node) {
+	if (node.type === "Identifier") return [node.name];
+	if (node.type === "ObjectPattern") return node.properties.flatMap((property) => bindingNames(property.type === "RestElement" ? property.argument : property.value));
+	if (node.type === "ArrayPattern") return node.elements.flatMap((element) => element ? bindingNames(element) : []);
+	if (node.type === "AssignmentPattern") return bindingNames(node.left);
+	if (node.type === "RestElement") return bindingNames(node.argument);
+	return [];
+}
+/** Read each source module once; never import or execute application code. */
+function collectFiles(cwd, warnings = []) {
+	cwd = path.resolve(cwd);
+	const paths = [];
+	const scan = (directory) => {
+		if (!existsSync(directory)) return;
+		try {
+			for (const entry of readdirSync(directory, { withFileTypes: true })) {
+				const file = path.join(directory, entry.name);
+				if (entry.isDirectory()) scan(file);
+				else if (entry.isFile()) paths.push(file);
+			}
+		} catch (error) {
+			warnings.push({
+				code: null,
+				source: projectFile(cwd, directory),
+				message: String(error)
+			});
+		}
+	};
+	scan(path.join(cwd, "src"));
+	paths.sort();
+	const known = new Set(paths);
+	let tsconfig;
+	try {
+		if (existsSync(path.join(cwd, "tsconfig.json"))) tsconfig = readTsconfig(path.join(cwd, "tsconfig.json"), { typescriptVersion: false });
+	} catch (error) {
+		warnings.push({
+			code: null,
+			source: "tsconfig.json",
+			message: String(error)
+		});
+	}
+	const probe = (base) => {
+		const extension = path.extname(base);
+		const stem = /\.[cm]?jsx?$/.test(extension) ? base.slice(0, -extension.length) : base;
+		const candidates = stem !== base ? EXTENSIONS.map((ext) => stem + ext) : [];
+		candidates.push(base, ...EXTENSIONS.map((ext) => base + ext), ...EXTENSIONS.map((ext) => path.join(base, `index${ext}`)));
+		return candidates.find((candidate) => known.has(candidate));
+	};
+	const files = paths.map((absolute) => {
+		const file = projectFile(cwd, absolute);
+		const parts = file.split("/");
+		const record = {
+			file,
+			module: parts[1] === "app" && parts.length > 3 ? parts.slice(0, 3).join("/") : path.posix.dirname(file).split("/").slice(0, 2).join("/"),
+			role: fileRole(file),
+			exports: [],
+			imports: [],
+			importedBy: []
+		};
+		if (!CODE.test(file)) return record;
+		try {
+			const parsed = parseSync(absolute, readFileSync(absolute, "utf8"));
+			for (const error of parsed.errors) warnings.push({
+				code: null,
+				source: file,
+				message: error.message
+			});
+			const exports = /* @__PURE__ */ new Set();
+			const imports = /* @__PURE__ */ new Set();
+			for (const statement of parsed.program.body) {
+				if (statement.type === "ExportDefaultDeclaration") exports.add("default");
+				if (statement.type === "ExportAllDeclaration") exports.add(statement.exported ? statement.exported.type === "Identifier" ? statement.exported.name : String(statement.exported.value) : "*");
+				if (statement.type !== "ExportNamedDeclaration") continue;
+				for (const specifier of statement.specifiers) exports.add(specifier.exported.type === "Identifier" ? specifier.exported.name : String(specifier.exported.value));
+				const declaration = statement.declaration;
+				if (declaration?.type === "VariableDeclaration") for (const item of declaration.declarations) for (const name of bindingNames(item.id)) exports.add(name);
+				else if (declaration && "id" in declaration && declaration.id?.type === "Identifier") exports.add(declaration.id.name);
+			}
+			const visit = (node) => {
+				if ((node.type === "ImportDeclaration" || node.type === "ExportNamedDeclaration" || node.type === "ExportAllDeclaration" || node.type === "TSImportType") && node.source) imports.add(String(node.source.value));
+				if (node.type === "ImportExpression" && node.source.type === "Literal" && typeof node.source.value === "string") imports.add(node.source.value);
+				if (node.type === "TSImportEqualsDeclaration" && node.moduleReference.type === "TSExternalModuleReference" && typeof node.moduleReference.expression.value === "string") imports.add(node.moduleReference.expression.value);
+				forEachChild(node, visit);
+			};
+			visit(parsed.program);
+			record.exports = [...exports].sort();
+			record.imports = [...imports].sort().map((specifier) => {
+				const resolved = (specifier.startsWith(".") ? [path.resolve(path.dirname(absolute), specifier)] : tsconfig ? resolvePathAlias(tsconfig, specifier) : []).map(probe).find((candidate) => candidate !== void 0);
+				return {
+					specifier,
+					file: resolved ? projectFile(cwd, resolved) : null
+				};
+			});
+		} catch (error) {
+			warnings.push({
+				code: null,
+				source: file,
+				message: String(error)
+			});
+		}
+		return record;
+	});
+	const byFile = new Map(files.map((file) => [file.file, file]));
+	for (const file of files) for (const imported of file.imports) if (imported.file) byFile.get(imported.file)?.importedBy.push(file.file);
+	for (const file of files) file.importedBy = [...new Set(file.importedBy)].sort();
+	return files;
+}
+
+//#endregion
+export { collectFiles, fileRole, projectFile };
+//# sourceMappingURL=collect-files.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-files.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { readTsconfig, resolvePathAlias } from \"get-tsconfig\";\nimport { parseSync, type Node } from \"oxc-parser\";\nimport {\n  isConfigFile,\n  isEventFile,\n  isLocaleFile,\n  isMainFile,\n  isRouteFile,\n  isWorkerFile,\n} from \"../../dev-server/special-file-patterns\";\nimport { forEachChild } from \"../syntax/ast\";\nimport type { InspectFile, InspectWarning } from \"./inspect-report.types\";\n\nconst CODE = /\\.(?:[cm]?[jt]s|[jt]sx)$/;\nconst EXTENSIONS = [\".ts\", \".tsx\", \".mts\", \".cts\", \".js\", \".jsx\", \".mjs\", \".cjs\", \".d.ts\"];\n\nexport function projectFile(cwd: string, file: string): string {\n  return path.relative(cwd, path.resolve(cwd, file)).split(path.sep).join(\"/\");\n}\n\n/** Infer a role from file names and the framework's directory conventions. */\nexport function fileRole(file: string): string {\n  const stem = path.posix.basename(file).replace(CODE, \"\");\n  if (/(?:^|\\.)(?:spec|test)$/.test(stem)) return \"spec\";\n  if (file.endsWith(\".d.ts\")) return \"type\";\n  if (isConfigFile(file)) return \"config\";\n  if (isRouteFile(file)) return \"routes\";\n  if (isMainFile(file)) return \"main\";\n  if (isWorkerFile(file)) return \"worker\";\n  if (isEventFile(file)) return \"event\";\n  if (isLocaleFile(file)) return \"locale\";\n  for (const role of [\"routes\", \"page\", \"setup\", \"layout\", \"root\"]) {\n    if (stem === role || stem.endsWith(`.${role}`)) return role;\n  }\n  for (const role of [\n    \"controller\",\n    \"service\",\n    \"repository\",\n    \"model\",\n    \"migration\",\n    \"schema\",\n    \"resource\",\n    \"hook\",\n    \"component\",\n    \"util\",\n    \"type\",\n    \"config\",\n  ]) {\n    if (\n      stem.endsWith(`.${role}`) ||\n      file.split(\"/\").includes(role === \"repository\" ? \"repositories\" : `${role}s`)\n    )\n      return role;\n  }\n  if (file.startsWith(\"src/config/\")) return \"config\";\n  if (file.split(\"/\").includes(\"utils\")) return \"util\";\n  if (/^use[A-Z]/.test(stem)) return \"hook\";\n  if (/\\.tsx$|\\.jsx$/.test(file)) return \"component\";\n  return \"source\";\n}\n\nfunction bindingNames(node: Node): string[] {\n  if (node.type === \"Identifier\") return [node.name];\n  if (node.type === \"ObjectPattern\")\n    return node.properties.flatMap((property) =>\n      bindingNames(property.type === \"RestElement\" ? property.argument : property.value),\n    );\n  if (node.type === \"ArrayPattern\")\n    return node.elements.flatMap((element) => (element ? bindingNames(element) : []));\n  if (node.type === \"AssignmentPattern\") return bindingNames(node.left);\n  if (node.type === \"RestElement\") return bindingNames(node.argument);\n  return [];\n}\n\n/** Read each source module once; never import or execute application code. */\nexport function collectFiles(cwd: string, warnings: InspectWarning[] = []): InspectFile[] {\n  cwd = path.resolve(cwd);\n  const paths: string[] = [];\n  const scan = (directory: string): void => {\n    if (!existsSync(directory)) return;\n    try {\n      for (const entry of readdirSync(directory, { withFileTypes: true })) {\n        const file = path.join(directory, entry.name);\n        if (entry.isDirectory()) scan(file);\n        else if (entry.isFile()) paths.push(file);\n      }\n    } catch (error) {\n      warnings.push({ code: null, source: projectFile(cwd, directory), message: String(error) });\n    }\n  };\n  scan(path.join(cwd, \"src\"));\n  paths.sort();\n  const known = new Set(paths);\n  let tsconfig: ReturnType<typeof readTsconfig> | undefined;\n  try {\n    if (existsSync(path.join(cwd, \"tsconfig.json\")))\n      tsconfig = readTsconfig(path.join(cwd, \"tsconfig.json\"), { typescriptVersion: false });\n  } catch (error) {\n    warnings.push({ code: null, source: \"tsconfig.json\", message: String(error) });\n  }\n  const probe = (base: string): string | undefined => {\n    const extension = path.extname(base);\n    const stem = /\\.[cm]?jsx?$/.test(extension) ? base.slice(0, -extension.length) : base;\n    const candidates = stem !== base ? EXTENSIONS.map((ext) => stem + ext) : [];\n    candidates.push(\n      base,\n      ...EXTENSIONS.map((ext) => base + ext),\n      ...EXTENSIONS.map((ext) => path.join(base, `index${ext}`)),\n    );\n    return candidates.find((candidate) => known.has(candidate));\n  };\n  const files = paths.map((absolute): InspectFile => {\n    const file = projectFile(cwd, absolute);\n    const parts = file.split(\"/\");\n    const record: InspectFile = {\n      file,\n      module:\n        parts[1] === \"app\" && parts.length > 3\n          ? parts.slice(0, 3).join(\"/\")\n          : path.posix.dirname(file).split(\"/\").slice(0, 2).join(\"/\"),\n      role: fileRole(file),\n      exports: [],\n      imports: [],\n      importedBy: [],\n    };\n    if (!CODE.test(file)) return record;\n    try {\n      const parsed = parseSync(absolute, readFileSync(absolute, \"utf8\"));\n      for (const error of parsed.errors)\n        warnings.push({ code: null, source: file, message: error.message });\n      const exports = new Set<string>();\n      const imports = new Set<string>();\n      for (const statement of parsed.program.body) {\n        if (statement.type === \"ExportDefaultDeclaration\") exports.add(\"default\");\n        if (statement.type === \"ExportAllDeclaration\")\n          exports.add(\n            statement.exported\n              ? statement.exported.type === \"Identifier\"\n                ? statement.exported.name\n                : String(statement.exported.value)\n              : \"*\",\n          );\n        if (statement.type !== \"ExportNamedDeclaration\") continue;\n        for (const specifier of statement.specifiers)\n          exports.add(\n            specifier.exported.type === \"Identifier\"\n              ? specifier.exported.name\n              : String(specifier.exported.value),\n          );\n        const declaration = statement.declaration;\n        if (declaration?.type === \"VariableDeclaration\") {\n          for (const item of declaration.declarations)\n            for (const name of bindingNames(item.id)) exports.add(name);\n        } else if (declaration && \"id\" in declaration && declaration.id?.type === \"Identifier\")\n          exports.add(declaration.id.name);\n      }\n      const visit = (node: Node): void => {\n        if (\n          (node.type === \"ImportDeclaration\" ||\n            node.type === \"ExportNamedDeclaration\" ||\n            node.type === \"ExportAllDeclaration\" ||\n            node.type === \"TSImportType\") &&\n          node.source\n        )\n          imports.add(String(node.source.value));\n        if (\n          node.type === \"ImportExpression\" &&\n          node.source.type === \"Literal\" &&\n          typeof node.source.value === \"string\"\n        )\n          imports.add(node.source.value);\n        if (\n          node.type === \"TSImportEqualsDeclaration\" &&\n          node.moduleReference.type === \"TSExternalModuleReference\" &&\n          typeof node.moduleReference.expression.value === \"string\"\n        )\n          imports.add(node.moduleReference.expression.value);\n        forEachChild(node, visit);\n      };\n      visit(parsed.program);\n      record.exports = [...exports].sort();\n      record.imports = [...imports].sort().map((specifier) => {\n        const bases = specifier.startsWith(\".\")\n          ? [path.resolve(path.dirname(absolute), specifier)]\n          : tsconfig\n            ? resolvePathAlias(tsconfig, specifier)\n            : [];\n        const resolved = bases.map(probe).find((candidate) => candidate !== undefined);\n        return { specifier, file: resolved ? projectFile(cwd, resolved) : null };\n      });\n    } catch (error) {\n      warnings.push({ code: null, source: file, message: String(error) });\n    }\n    return record;\n  });\n  const byFile = new Map(files.map((file) => [file.file, file]));\n  for (const file of files)\n    for (const imported of file.imports) {\n      if (imported.file) byFile.get(imported.file)?.importedBy.push(file.file);\n    }\n  for (const file of files) file.importedBy = [...new Set(file.importedBy)].sort();\n  return files;\n}\n"],"mappings":"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"}

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

@@ -71,9 +71,10 @@ function exportsName(file, name) {
 *
 * @param pages The connector's installed page records; see {@link installedPagesFromConnectors}.
 */
-function collectPages(pages, cwd, warnings) {
+function collectPages(pages, cwd, warnings, files) {
 	if (!pages) return [];
 	const collected = [];
+	const exports = files ? new Map(files.map((file) => [file.file, file.exports])) : void 0;
 	for (const page of pages) {
 		if (!isInstalledPage(page)) {
 			warnings.push({
@@ -85,7 +86,7 @@ function collectPages(pages, cwd, warnings) {
 		}
 		const pageFile = path.isAbsolute(page.file) ? page.file : path.join(cwd, page.file);
 		const layouts = layoutChainOf(pageFile, cwd);
-		const loaders = [...layouts, pageFile].filter((file) => exportsName(file, "loader"));
+		const loaders = [...layouts, pageFile].filter((file) => exports ? exports.get(relativeTo(cwd, file))?.includes("loader") === true : exportsName(file, "loader"));
 		const actions = Array.isArray(page.actions) ? page.actions.filter((action) => typeof action === "string") : [];
 		collected.push({
 			path: page.path,

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

@@ -1 +1 @@
-{"version":3,"file":"collect-pages.mjs","names":["ast.parseSourceFile","ast.topLevelDeclarations","ast.hasModifier","ast.isVariableStatement","ast.isIdentifier","ast.nameNode","ast.valueText","ast.isFunctionDeclaration","ast.declarationName","ast.isExportDeclaration"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-pages.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as ast from \"../syntax/ast\";\nimport { connectorsManager } from \"../../connectors/connectors-manager\";\nimport type { InspectPage, InspectWarning } from \"./inspect-report.types\";\n\n/** The fields of `@warlock.js/web`'s installed page record that inspect reads. */\ntype InstalledPageLike = {\n  path: string;\n  name?: unknown;\n  file: string;\n  actions?: unknown;\n  guard?: unknown;\n};\n\nfunction isInstalledPage(value: unknown): value is InstalledPageLike {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof Reflect.get(value, \"path\") === \"string\" &&\n    typeof Reflect.get(value, \"file\") === \"string\"\n  );\n}\n\n/**\n * The pages the `web` connector installed, read through its public\n * `getInstalledPages()` without importing `@warlock.js/web`. `undefined` when\n * no such connector is registered (an API-only app).\n */\nexport function installedPagesFromConnectors(): unknown[] | undefined {\n  const web = connectorsManager.list().find((connector) => connector.name === \"web\");\n  const read = web ? Reflect.get(web, \"getInstalledPages\") : undefined;\n\n  if (typeof read !== \"function\") return undefined;\n\n  const pages: unknown = read.call(web);\n\n  return Array.isArray(pages) ? pages : undefined;\n}\n\nfunction toPosix(file: string): string {\n  return file.split(path.sep).join(\"/\");\n}\n\nfunction relativeTo(cwd: string, file: string): string {\n  return toPosix(path.isAbsolute(file) ? path.relative(cwd, file) : file);\n}\n\n/**\n * The page's layout chain, outermost first: every `layout.tsx` from the web\n * root (the nearest ancestor holding `root.tsx`, else `src/`) down to the\n * page's own directory — the rule `@warlock.js/web` applies.\n */\nexport function layoutChainOf(pageFile: string, cwd: string): string[] {\n  const srcRoot = path.join(cwd, \"src\");\n  const directories: string[] = [];\n  let current = path.dirname(pageFile);\n\n  while (current.startsWith(srcRoot)) {\n    directories.unshift(current);\n\n    if (existsSync(path.join(current, \"root.tsx\")) || current === srcRoot) break;\n\n    const parent = path.dirname(current);\n\n    if (parent === current) break;\n\n    current = parent;\n  }\n\n  return directories\n    .map((directory) => path.join(directory, \"layout.tsx\"))\n    .filter((candidate) => existsSync(candidate));\n}\n\n/**\n * Whether a module's source exports a binding named `name`, read with the\n * OXC parser (the page files are TSX that Node cannot import directly).\n */\nexport function exportsName(file: string, name: string): boolean {\n  let source: string;\n\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return false;\n  }\n\n  const sourceFile = ast.parseSourceFile(file, source);\n\n  for (const statement of ast.topLevelDeclarations(sourceFile)) {\n    const exported = ast.hasModifier(statement, \"export\");\n\n    if (exported && ast.isVariableStatement(statement)) {\n      if (\n        statement.declarations.some(\n          (declaration) =>\n            ast.isIdentifier(ast.nameNode(declaration)) && ast.valueText(declaration.id) === name,\n        )\n      ) {\n        return true;\n      }\n    }\n\n    if (\n      exported &&\n      ast.isFunctionDeclaration(statement) &&\n      ast.declarationName(statement) === name\n    ) {\n      return true;\n    }\n\n    if (\n      ast.isExportDeclaration(statement) &&\n      statement.specifiers.some((element) => ast.valueText(element.exported) === name)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Describe the installed pages: route path and name, page file, layout chain,\n * the files on that chain exporting a `loader`, actions and guard.\n *\n * @param pages The connector's installed page records; see {@link installedPagesFromConnectors}.\n */\nexport function collectPages(\n  pages: readonly unknown[] | undefined,\n  cwd: string,\n  warnings: InspectWarning[],\n): InspectPage[] {\n  if (!pages) return [];\n\n  const collected: InspectPage[] = [];\n\n  for (const page of pages) {\n    if (!isInstalledPage(page)) {\n      warnings.push({ code: null, message: \"A page record has no path or file.\", source: \"pages\" });\n      continue;\n    }\n\n    const pageFile = path.isAbsolute(page.file) ? page.file : path.join(cwd, page.file);\n    const layouts = layoutChainOf(pageFile, cwd);\n    const loaders = [...layouts, pageFile].filter((file) => exportsName(file, \"loader\"));\n    const actions = Array.isArray(page.actions)\n      ? page.actions.filter((action): action is string => typeof action === \"string\")\n      : [];\n\n    collected.push({\n      path: page.path,\n      name: typeof page.name === \"string\" && page.name.length > 0 ? page.name : null,\n      file: relativeTo(cwd, pageFile),\n      layouts: layouts.map((file) => relativeTo(cwd, file)),\n      loaders: loaders.map((file) => relativeTo(cwd, file)),\n      actions: [...actions].sort(),\n      guard: typeof page.guard === \"string\" ? page.guard : null,\n    });\n  }\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return first.file.localeCompare(second.file);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"collect-pages.mjs","names":["ast.parseSourceFile","ast.topLevelDeclarations","ast.hasModifier","ast.isVariableStatement","ast.isIdentifier","ast.nameNode","ast.valueText","ast.isFunctionDeclaration","ast.declarationName","ast.isExportDeclaration"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-pages.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as ast from \"../syntax/ast\";\nimport { connectorsManager } from \"../../connectors/connectors-manager\";\nimport type { InspectFile, InspectPage, InspectWarning } from \"./inspect-report.types\";\n\n/** The fields of `@warlock.js/web`'s installed page record that inspect reads. */\ntype InstalledPageLike = {\n  path: string;\n  name?: unknown;\n  file: string;\n  actions?: unknown;\n  guard?: unknown;\n};\n\nfunction isInstalledPage(value: unknown): value is InstalledPageLike {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof Reflect.get(value, \"path\") === \"string\" &&\n    typeof Reflect.get(value, \"file\") === \"string\"\n  );\n}\n\n/**\n * The pages the `web` connector installed, read through its public\n * `getInstalledPages()` without importing `@warlock.js/web`. `undefined` when\n * no such connector is registered (an API-only app).\n */\nexport function installedPagesFromConnectors(): unknown[] | undefined {\n  const web = connectorsManager.list().find((connector) => connector.name === \"web\");\n  const read = web ? Reflect.get(web, \"getInstalledPages\") : undefined;\n\n  if (typeof read !== \"function\") return undefined;\n\n  const pages: unknown = read.call(web);\n\n  return Array.isArray(pages) ? pages : undefined;\n}\n\nfunction toPosix(file: string): string {\n  return file.split(path.sep).join(\"/\");\n}\n\nfunction relativeTo(cwd: string, file: string): string {\n  return toPosix(path.isAbsolute(file) ? path.relative(cwd, file) : file);\n}\n\n/**\n * The page's layout chain, outermost first: every `layout.tsx` from the web\n * root (the nearest ancestor holding `root.tsx`, else `src/`) down to the\n * page's own directory — the rule `@warlock.js/web` applies.\n */\nexport function layoutChainOf(pageFile: string, cwd: string): string[] {\n  const srcRoot = path.join(cwd, \"src\");\n  const directories: string[] = [];\n  let current = path.dirname(pageFile);\n\n  while (current.startsWith(srcRoot)) {\n    directories.unshift(current);\n\n    if (existsSync(path.join(current, \"root.tsx\")) || current === srcRoot) break;\n\n    const parent = path.dirname(current);\n\n    if (parent === current) break;\n\n    current = parent;\n  }\n\n  return directories\n    .map((directory) => path.join(directory, \"layout.tsx\"))\n    .filter((candidate) => existsSync(candidate));\n}\n\n/**\n * Whether a module's source exports a binding named `name`, read with the\n * OXC parser (the page files are TSX that Node cannot import directly).\n */\nexport function exportsName(file: string, name: string): boolean {\n  let source: string;\n\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return false;\n  }\n\n  const sourceFile = ast.parseSourceFile(file, source);\n\n  for (const statement of ast.topLevelDeclarations(sourceFile)) {\n    const exported = ast.hasModifier(statement, \"export\");\n\n    if (exported && ast.isVariableStatement(statement)) {\n      if (\n        statement.declarations.some(\n          (declaration) =>\n            ast.isIdentifier(ast.nameNode(declaration)) && ast.valueText(declaration.id) === name,\n        )\n      ) {\n        return true;\n      }\n    }\n\n    if (\n      exported &&\n      ast.isFunctionDeclaration(statement) &&\n      ast.declarationName(statement) === name\n    ) {\n      return true;\n    }\n\n    if (\n      ast.isExportDeclaration(statement) &&\n      statement.specifiers.some((element) => ast.valueText(element.exported) === name)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Describe the installed pages: route path and name, page file, layout chain,\n * the files on that chain exporting a `loader`, actions and guard.\n *\n * @param pages The connector's installed page records; see {@link installedPagesFromConnectors}.\n */\nexport function collectPages(\n  pages: readonly unknown[] | undefined,\n  cwd: string,\n  warnings: InspectWarning[],\n  files?: readonly InspectFile[],\n): InspectPage[] {\n  if (!pages) return [];\n\n  const collected: InspectPage[] = [];\n  const exports = files ? new Map(files.map((file) => [file.file, file.exports])) : undefined;\n\n  for (const page of pages) {\n    if (!isInstalledPage(page)) {\n      warnings.push({ code: null, message: \"A page record has no path or file.\", source: \"pages\" });\n      continue;\n    }\n\n    const pageFile = path.isAbsolute(page.file) ? page.file : path.join(cwd, page.file);\n    const layouts = layoutChainOf(pageFile, cwd);\n    const loaders = [...layouts, pageFile].filter((file) =>\n      exports\n        ? exports.get(relativeTo(cwd, file))?.includes(\"loader\") === true\n        : exportsName(file, \"loader\"),\n    );\n    const actions = Array.isArray(page.actions)\n      ? page.actions.filter((action): action is string => typeof action === \"string\")\n      : [];\n\n    collected.push({\n      path: page.path,\n      name: typeof page.name === \"string\" && page.name.length > 0 ? page.name : null,\n      file: relativeTo(cwd, pageFile),\n      layouts: layouts.map((file) => relativeTo(cwd, file)),\n      loaders: loaders.map((file) => relativeTo(cwd, file)),\n      actions: [...actions].sort(),\n      guard: typeof page.guard === \"string\" ? page.guard : null,\n    });\n  }\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return first.file.localeCompare(second.file);\n  });\n}\n"],"mappings":";;;;;;AAeA,SAAS,gBAAgB,OAA4C;CACnE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,QAAQ,IAAI,OAAO,MAAM,MAAM,YACtC,OAAO,QAAQ,IAAI,OAAO,MAAM,MAAM;AAE1C;;;;;;AAOA,SAAgB,+BAAsD;CACpE,MAAM,MAAM,kBAAkB,KAAK,CAAC,CAAC,MAAM,cAAc,UAAU,SAAS,KAAK;CACjF,MAAM,OAAO,MAAM,QAAQ,IAAI,KAAK,mBAAmB,IAAI;CAE3D,IAAI,OAAO,SAAS,YAAY,OAAO;CAEvC,MAAM,QAAiB,KAAK,KAAK,GAAG;CAEpC,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ;AACxC;AAEA,SAAS,QAAQ,MAAsB;CACrC,OAAO,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AACtC;AAEA,SAAS,WAAW,KAAa,MAAsB;CACrD,OAAO,QAAQ,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,KAAK,IAAI,IAAI,IAAI;AACxE;;;;;;AAOA,SAAgB,cAAc,UAAkB,KAAuB;CACrE,MAAM,UAAU,KAAK,KAAK,KAAK,KAAK;CACpC,MAAM,cAAwB,CAAC;CAC/B,IAAI,UAAU,KAAK,QAAQ,QAAQ;CAEnC,OAAO,QAAQ,WAAW,OAAO,GAAG;EAClC,YAAY,QAAQ,OAAO;EAE3B,IAAI,WAAW,KAAK,KAAK,SAAS,UAAU,CAAC,KAAK,YAAY,SAAS;EAEvE,MAAM,SAAS,KAAK,QAAQ,OAAO;EAEnC,IAAI,WAAW,SAAS;EAExB,UAAU;CACZ;CAEA,OAAO,YACJ,KAAK,cAAc,KAAK,KAAK,WAAW,YAAY,CAAC,CAAC,CACtD,QAAQ,cAAc,WAAW,SAAS,CAAC;AAChD;;;;;AAMA,SAAgB,YAAY,MAAc,MAAuB;CAC/D,IAAI;CAEJ,IAAI;EACF,SAAS,aAAa,MAAM,MAAM;CACpC,QAAQ;EACN,OAAO;CACT;CAEA,MAAM,aAAaA,gBAAoB,MAAM,MAAM;CAEnD,KAAK,MAAM,aAAaC,qBAAyB,UAAU,GAAG;EAC5D,MAAM,WAAWC,YAAgB,WAAW,QAAQ;EAEpD,IAAI,YAAYC,oBAAwB,SAAS,GAC/C;OACE,UAAU,aAAa,MACpB,gBACCC,aAAiBC,SAAa,WAAW,CAAC,KAAKC,UAAc,YAAY,EAAE,MAAM,IACrF,GAEA,OAAO;EACT;EAGF,IACE,YACAC,sBAA0B,SAAS,KACnCC,gBAAoB,SAAS,MAAM,MAEnC,OAAO;EAGT,IACEC,oBAAwB,SAAS,KACjC,UAAU,WAAW,MAAM,YAAYH,UAAc,QAAQ,QAAQ,MAAM,IAAI,GAE/E,OAAO;CAEX;CAEA,OAAO;AACT;;;;;;;AAQA,SAAgB,aACd,OACA,KACA,UACA,OACe;CACf,IAAI,CAAC,OAAO,OAAO,CAAC;CAEpB,MAAM,YAA2B,CAAC;CAClC,MAAM,UAAU,QAAQ,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,KAAK,MAAM,KAAK,OAAO,CAAC,CAAC,IAAI;CAElF,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,gBAAgB,IAAI,GAAG;GAC1B,SAAS,KAAK;IAAE,MAAM;IAAM,SAAS;IAAsC,QAAQ;GAAQ,CAAC;GAC5F;EACF;EAEA,MAAM,WAAW,KAAK,WAAW,KAAK,IAAI,IAAI,KAAK,OAAO,KAAK,KAAK,KAAK,KAAK,IAAI;EAClF,MAAM,UAAU,cAAc,UAAU,GAAG;EAC3C,MAAM,UAAU,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAC,QAAQ,SAC7C,UACI,QAAQ,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,EAAE,SAAS,QAAQ,MAAM,OAC3D,YAAY,MAAM,QAAQ,CAChC;EACA,MAAM,UAAU,MAAM,QAAQ,KAAK,OAAO,IACtC,KAAK,QAAQ,QAAQ,WAA6B,OAAO,WAAW,QAAQ,IAC5E,CAAC;EAEL,UAAU,KAAK;GACb,MAAM,KAAK;GACX,MAAM,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,KAAK,OAAO;GAC1E,MAAM,WAAW,KAAK,QAAQ;GAC9B,SAAS,QAAQ,KAAK,SAAS,WAAW,KAAK,IAAI,CAAC;GACpD,SAAS,QAAQ,KAAK,SAAS,WAAW,KAAK,IAAI,CAAC;GACpD,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK;GAC3B,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;EACvD,CAAC;CACH;CAEA,OAAO,UAAU,MAAM,OAAO,WAAW;EACvC,IAAI,MAAM,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,OAAO,OAAO,KAAK;EAEvE,OAAO,MAAM,KAAK,cAAc,OAAO,IAAI;CAC7C,CAAC;AACH"}

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

@@ -134,7 +134,7 @@ function collectRoutes(routes, registry, warnings) {
 			isPage: route.isPage === true,
 			middleware: (route.middleware ?? []).map(functionName),
 			auth: auth ? {
-				required: true,
+				required: auth.required !== false,
 				sources: auth.sources,
 				userTypes: auth.userTypes
 			} : {

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

@@ -1 +1 @@
-{"version":3,"file":"collect-routes.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-routes.ts"],"sourcesContent":["import { config } from \"../../config/config-getter\";\nimport { buildRateLimitOptions } from \"../../http/build-rate-limit-options\";\nimport type { HttpLoggingConfig } from \"../../http/request-log-snapshot\";\nimport { expandMethods } from \"../../openapi/paths\";\nimport { buildRequestParts } from \"../../openapi/request-schemas\";\nimport { buildDeclaredResponses } from \"../../openapi/response-schemas\";\nimport type { SchemaRegistry } from \"../../openapi/schema-registry\";\nimport { readRouteAuth } from \"../../openapi/security\";\nimport type { Route } from \"../../router/types\";\nimport type {\n  InspectRoute,\n  InspectRouteLogging,\n  InspectRouteRateLimit,\n  InspectWarning,\n  JsonSchema,\n} from \"./inspect-report.types\";\n\n/** Display order of methods within one path, matching `warlock routes`. */\nconst METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"OPTIONS\", \"HEAD\", \"ALL\"];\n\nfunction methodRank(method: string): number {\n  const index = METHOD_ORDER.indexOf(method);\n\n  return index === -1 ? METHOD_ORDER.length : index;\n}\n\n/** The name of a function, without the `bound ` prefix `bind()` adds. */\nexport function functionName(value: unknown): string {\n  if (typeof value !== \"function\") return \"anonymous\";\n\n  const name = value.name.replace(/^bound /, \"\").trim();\n\n  return name.length > 0 ? name : \"anonymous\";\n}\n\nfunction limitValue(value: unknown): number | \"dynamic\" | null {\n  if (typeof value === \"number\") return value;\n\n  return value === undefined || value === null ? null : \"dynamic\";\n}\n\nfunction windowValue(value: unknown): number | string | null {\n  if (typeof value === \"number\" || typeof value === \"string\") return value;\n\n  return value === undefined || value === null ? null : \"dynamic\";\n}\n\n/**\n * The limiter a route runs under: its own `rateLimit` options, else the global\n * `http.rateLimit` limiter (built with the same defaults the HTTP connector\n * uses), else none. `rateLimit: false` exempts the route from the global\n * limiter; `rateLimit: true` keeps it under the global policy.\n */\nfunction readRateLimit(\n  route: Route,\n  global: Record<string, unknown> | null,\n): InspectRouteRateLimit {\n  if (typeof route.rateLimit === \"object\" && route.rateLimit !== null) {\n    return { source: \"route\", max: route.rateLimit.max, timeWindow: route.rateLimit.timeWindow };\n  }\n\n  if (!global || route.rateLimit === false) {\n    return { source: \"none\", max: null, timeWindow: null };\n  }\n\n  return {\n    source: \"global\",\n    max: limitValue(global.max),\n    timeWindow: windowValue(global.timeWindow),\n  };\n}\n\n/**\n * What the route's request logs keep: the route's `logging` option over\n * `http.logging`, the same precedence `resolveRequestLoggingOptions` applies.\n * Private URL rules can only remove more, per URL, so they are flagged rather\n * than evaluated.\n */\nfunction readLogging(route: Route, global: HttpLoggingConfig): InspectRouteLogging {\n  return {\n    body: route.logging?.body ?? global.body ?? true,\n    query: route.logging?.query ?? global.query ?? true,\n    privateRules: (global.private?.length ?? 0) > 0,\n  };\n}\n\nfunction globalRateLimit(warnings: InspectWarning[]): Record<string, unknown> | null {\n  try {\n    const options = buildRateLimitOptions(config.get(\"http.rateLimit\"));\n\n    return options ? { max: options.max, timeWindow: options.timeWindow } : null;\n  } catch (error) {\n    warnings.push({\n      code: null,\n      message: `http.rateLimit could not be read: ${error instanceof Error ? error.message : String(error)}`,\n      source: \"routes\",\n    });\n\n    return null;\n  }\n}\n\n/**\n * Describe every route: identity, middleware chain, guard, limits, logging and\n * the request/response schemas the OpenAPI generator derives (the same\n * `buildRequestParts` / `buildDeclaredResponses` code, so `inspect` and\n * `generate.openapi` never disagree). Resource `$ref`s land in `registry`.\n */\nexport function collectRoutes(\n  routes: readonly Route[],\n  registry: SchemaRegistry,\n  warnings: InspectWarning[],\n): InspectRoute[] {\n  const rateLimit = globalRateLimit(warnings);\n  const logging = (config.get(\"http.logging\") ?? {}) as HttpLoggingConfig;\n\n  const collected = routes.map((route): InspectRoute => {\n    const method = String(route.method).toUpperCase();\n    const label = `${method} ${route.path}`;\n    const warn = (message: string) => {\n      warnings.push({\n        code: message.includes(\"JSON Schema\") ? \"WL4001\" : null,\n        message: `${label}: ${message}`,\n        source: route.sourceFile || null,\n      });\n    };\n    const handler = route.handler as Route[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const request = buildRequestParts({\n      method: expandMethods(route.method)[0] ?? \"get\",\n      path: route.path,\n      validation,\n      warn,\n    });\n    const body = request.requestBody?.content[\"application/json\"]?.schema;\n    const responses: InspectRoute[\"responses\"] = {};\n\n    for (const [status, response] of Object.entries(\n      buildDeclaredResponses(handler?.responseSchema, registry, warn),\n    )) {\n      const schema: JsonSchema | undefined = response.content?.[\"application/json\"]?.schema;\n\n      responses[status] = { description: response.description, schema: schema ?? null };\n    }\n\n    return {\n      method,\n      path: route.path,\n      name: route.name ? route.name : null,\n      sourceFile: route.sourceFile ? route.sourceFile : null,\n      handler: functionName(handler),\n      description: route.description ?? handler?.description ?? null,\n      isPage: route.isPage === true,\n      middleware: (route.middleware ?? []).map(functionName),\n      auth: auth\n        ? { required: true, sources: auth.sources, userTypes: auth.userTypes }\n        : { required: false, sources: [], userTypes: [] },\n      csrf: route.csrf !== false,\n      rateLimit: readRateLimit(route, rateLimit),\n      logging: readLogging(route, logging),\n      request: {\n        parameters: request.parameters.map((parameter) => ({\n          name: parameter.name,\n          in: parameter.in,\n          required: parameter.required === true,\n          schema: parameter.schema,\n        })),\n        body: body ?? null,\n        customValidation: typeof validation?.validate === \"function\",\n      },\n      responses,\n    };\n  });\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return methodRank(first.method) - methodRank(second.method);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"collect-routes.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-routes.ts"],"sourcesContent":["import { config } from \"../../config/config-getter\";\nimport { buildRateLimitOptions } from \"../../http/build-rate-limit-options\";\nimport type { HttpLoggingConfig } from \"../../http/request-log-snapshot\";\nimport { expandMethods } from \"../../openapi/paths\";\nimport { buildRequestParts } from \"../../openapi/request-schemas\";\nimport { buildDeclaredResponses } from \"../../openapi/response-schemas\";\nimport type { SchemaRegistry } from \"../../openapi/schema-registry\";\nimport { readRouteAuth } from \"../../openapi/security\";\nimport type { Route } from \"../../router/types\";\nimport type {\n  InspectRoute,\n  InspectRouteLogging,\n  InspectRouteRateLimit,\n  InspectWarning,\n  JsonSchema,\n} from \"./inspect-report.types\";\n\n/** Display order of methods within one path, matching `warlock routes`. */\nconst METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"OPTIONS\", \"HEAD\", \"ALL\"];\n\nfunction methodRank(method: string): number {\n  const index = METHOD_ORDER.indexOf(method);\n\n  return index === -1 ? METHOD_ORDER.length : index;\n}\n\n/** The name of a function, without the `bound ` prefix `bind()` adds. */\nexport function functionName(value: unknown): string {\n  if (typeof value !== \"function\") return \"anonymous\";\n\n  const name = value.name.replace(/^bound /, \"\").trim();\n\n  return name.length > 0 ? name : \"anonymous\";\n}\n\nfunction limitValue(value: unknown): number | \"dynamic\" | null {\n  if (typeof value === \"number\") return value;\n\n  return value === undefined || value === null ? null : \"dynamic\";\n}\n\nfunction windowValue(value: unknown): number | string | null {\n  if (typeof value === \"number\" || typeof value === \"string\") return value;\n\n  return value === undefined || value === null ? null : \"dynamic\";\n}\n\n/**\n * The limiter a route runs under: its own `rateLimit` options, else the global\n * `http.rateLimit` limiter (built with the same defaults the HTTP connector\n * uses), else none. `rateLimit: false` exempts the route from the global\n * limiter; `rateLimit: true` keeps it under the global policy.\n */\nfunction readRateLimit(\n  route: Route,\n  global: Record<string, unknown> | null,\n): InspectRouteRateLimit {\n  if (typeof route.rateLimit === \"object\" && route.rateLimit !== null) {\n    return { source: \"route\", max: route.rateLimit.max, timeWindow: route.rateLimit.timeWindow };\n  }\n\n  if (!global || route.rateLimit === false) {\n    return { source: \"none\", max: null, timeWindow: null };\n  }\n\n  return {\n    source: \"global\",\n    max: limitValue(global.max),\n    timeWindow: windowValue(global.timeWindow),\n  };\n}\n\n/**\n * What the route's request logs keep: the route's `logging` option over\n * `http.logging`, the same precedence `resolveRequestLoggingOptions` applies.\n * Private URL rules can only remove more, per URL, so they are flagged rather\n * than evaluated.\n */\nfunction readLogging(route: Route, global: HttpLoggingConfig): InspectRouteLogging {\n  return {\n    body: route.logging?.body ?? global.body ?? true,\n    query: route.logging?.query ?? global.query ?? true,\n    privateRules: (global.private?.length ?? 0) > 0,\n  };\n}\n\nfunction globalRateLimit(warnings: InspectWarning[]): Record<string, unknown> | null {\n  try {\n    const options = buildRateLimitOptions(config.get(\"http.rateLimit\"));\n\n    return options ? { max: options.max, timeWindow: options.timeWindow } : null;\n  } catch (error) {\n    warnings.push({\n      code: null,\n      message: `http.rateLimit could not be read: ${error instanceof Error ? error.message : String(error)}`,\n      source: \"routes\",\n    });\n\n    return null;\n  }\n}\n\n/**\n * Describe every route: identity, middleware chain, guard, limits, logging and\n * the request/response schemas the OpenAPI generator derives (the same\n * `buildRequestParts` / `buildDeclaredResponses` code, so `inspect` and\n * `generate.openapi` never disagree). Resource `$ref`s land in `registry`.\n */\nexport function collectRoutes(\n  routes: readonly Route[],\n  registry: SchemaRegistry,\n  warnings: InspectWarning[],\n): InspectRoute[] {\n  const rateLimit = globalRateLimit(warnings);\n  const logging = (config.get(\"http.logging\") ?? {}) as HttpLoggingConfig;\n\n  const collected = routes.map((route): InspectRoute => {\n    const method = String(route.method).toUpperCase();\n    const label = `${method} ${route.path}`;\n    const warn = (message: string) => {\n      warnings.push({\n        code: message.includes(\"JSON Schema\") ? \"WL4001\" : null,\n        message: `${label}: ${message}`,\n        source: route.sourceFile || null,\n      });\n    };\n    const handler = route.handler as Route[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const request = buildRequestParts({\n      method: expandMethods(route.method)[0] ?? \"get\",\n      path: route.path,\n      validation,\n      warn,\n    });\n    const body = request.requestBody?.content[\"application/json\"]?.schema;\n    const responses: InspectRoute[\"responses\"] = {};\n\n    for (const [status, response] of Object.entries(\n      buildDeclaredResponses(handler?.responseSchema, registry, warn),\n    )) {\n      const schema: JsonSchema | undefined = response.content?.[\"application/json\"]?.schema;\n\n      responses[status] = { description: response.description, schema: schema ?? null };\n    }\n\n    return {\n      method,\n      path: route.path,\n      name: route.name ? route.name : null,\n      sourceFile: route.sourceFile ? route.sourceFile : null,\n      handler: functionName(handler),\n      description: route.description ?? handler?.description ?? null,\n      isPage: route.isPage === true,\n      middleware: (route.middleware ?? []).map(functionName),\n      auth: auth\n        ? { required: auth.required !== false, sources: auth.sources, userTypes: auth.userTypes }\n        : { required: false, sources: [], userTypes: [] },\n      csrf: route.csrf !== false,\n      rateLimit: readRateLimit(route, rateLimit),\n      logging: readLogging(route, logging),\n      request: {\n        parameters: request.parameters.map((parameter) => ({\n          name: parameter.name,\n          in: parameter.in,\n          required: parameter.required === true,\n          schema: parameter.schema,\n        })),\n        body: body ?? null,\n        customValidation: typeof validation?.validate === \"function\",\n      },\n      responses,\n    };\n  });\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return methodRank(first.method) - methodRank(second.method);\n  });\n}\n"],"mappings":";;;;;;;;;AAkBA,MAAM,eAAe;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;CAAQ;AAAK;AAEvF,SAAS,WAAW,QAAwB;CAC1C,MAAM,QAAQ,aAAa,QAAQ,MAAM;CAEzC,OAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;;AAGA,SAAgB,aAAa,OAAwB;CACnD,IAAI,OAAO,UAAU,YAAY,OAAO;CAExC,MAAM,OAAO,MAAM,KAAK,QAAQ,WAAW,EAAE,CAAC,CAAC,KAAK;CAEpD,OAAO,KAAK,SAAS,IAAI,OAAO;AAClC;AAEA,SAAS,WAAW,OAA2C;CAC7D,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,OAAO,UAAU,UAAa,UAAU,OAAO,OAAO;AACxD;AAEA,SAAS,YAAY,OAAwC;CAC3D,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,OAAO;CAEnE,OAAO,UAAU,UAAa,UAAU,OAAO,OAAO;AACxD;;;;;;;AAQA,SAAS,cACP,OACA,QACuB;CACvB,IAAI,OAAO,MAAM,cAAc,YAAY,MAAM,cAAc,MAC7D,OAAO;EAAE,QAAQ;EAAS,KAAK,MAAM,UAAU;EAAK,YAAY,MAAM,UAAU;CAAW;CAG7F,IAAI,CAAC,UAAU,MAAM,cAAc,OACjC,OAAO;EAAE,QAAQ;EAAQ,KAAK;EAAM,YAAY;CAAK;CAGvD,OAAO;EACL,QAAQ;EACR,KAAK,WAAW,OAAO,GAAG;EAC1B,YAAY,YAAY,OAAO,UAAU;CAC3C;AACF;;;;;;;AAQA,SAAS,YAAY,OAAc,QAAgD;CACjF,OAAO;EACL,MAAM,MAAM,SAAS,QAAQ,OAAO,QAAQ;EAC5C,OAAO,MAAM,SAAS,SAAS,OAAO,SAAS;EAC/C,eAAe,OAAO,SAAS,UAAU,KAAK;CAChD;AACF;AAEA,SAAS,gBAAgB,UAA4D;CACnF,IAAI;EACF,MAAM,UAAU,sBAAsB,OAAO,IAAI,gBAAgB,CAAC;EAElE,OAAO,UAAU;GAAE,KAAK,QAAQ;GAAK,YAAY,QAAQ;EAAW,IAAI;CAC1E,SAAS,OAAO;EACd,SAAS,KAAK;GACZ,MAAM;GACN,SAAS,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACnG,QAAQ;EACV,CAAC;EAED,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,cACd,QACA,UACA,UACgB;CAChB,MAAM,YAAY,gBAAgB,QAAQ;CAC1C,MAAM,UAAW,OAAO,IAAI,cAAc,KAAK,CAAC;CA6DhD,OA3DkB,OAAO,KAAK,UAAwB;EACpD,MAAM,SAAS,OAAO,MAAM,MAAM,CAAC,CAAC,YAAY;EAChD,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM;EACjC,MAAM,QAAQ,YAAoB;GAChC,SAAS,KAAK;IACZ,MAAM,QAAQ,SAAS,aAAa,IAAI,WAAW;IACnD,SAAS,GAAG,MAAM,IAAI;IACtB,QAAQ,MAAM,cAAc;GAC9B,CAAC;EACH;EACA,MAAM,UAAU,MAAM;EACtB,MAAM,aAAa,SAAS;EAC5B,MAAM,OAAO,cAAc,MAAM,YAAY,IAAI;EACjD,MAAM,UAAU,kBAAkB;GAChC,QAAQ,cAAc,MAAM,MAAM,CAAC,CAAC,MAAM;GAC1C,MAAM,MAAM;GACZ;GACA;EACF,CAAC;EACD,MAAM,OAAO,QAAQ,aAAa,QAAQ,mBAAmB,EAAE;EAC/D,MAAM,YAAuC,CAAC;EAE9C,KAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QACtC,uBAAuB,SAAS,gBAAgB,UAAU,IAAI,CAChE,GAAG;GACD,MAAM,SAAiC,SAAS,UAAU,mBAAmB,EAAE;GAE/E,UAAU,UAAU;IAAE,aAAa,SAAS;IAAa,QAAQ,UAAU;GAAK;EAClF;EAEA,OAAO;GACL;GACA,MAAM,MAAM;GACZ,MAAM,MAAM,OAAO,MAAM,OAAO;GAChC,YAAY,MAAM,aAAa,MAAM,aAAa;GAClD,SAAS,aAAa,OAAO;GAC7B,aAAa,MAAM,eAAe,SAAS,eAAe;GAC1D,QAAQ,MAAM,WAAW;GACzB,aAAa,MAAM,cAAc,CAAC,EAAC,CAAE,IAAI,YAAY;GACrD,MAAM,OACF;IAAE,UAAU,KAAK,aAAa;IAAO,SAAS,KAAK;IAAS,WAAW,KAAK;GAAU,IACtF;IAAE,UAAU;IAAO,SAAS,CAAC;IAAG,WAAW,CAAC;GAAE;GAClD,MAAM,MAAM,SAAS;GACrB,WAAW,cAAc,OAAO,SAAS;GACzC,SAAS,YAAY,OAAO,OAAO;GACnC,SAAS;IACP,YAAY,QAAQ,WAAW,KAAK,eAAe;KACjD,MAAM,UAAU;KAChB,IAAI,UAAU;KACd,UAAU,UAAU,aAAa;KACjC,QAAQ,UAAU;IACpB,EAAE;IACF,MAAM,QAAQ;IACd,kBAAkB,OAAO,YAAY,aAAa;GACpD;GACA;EACF;CACF,CAEe,CAAC,CAAC,MAAM,OAAO,WAAW;EACvC,IAAI,MAAM,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,OAAO,OAAO,KAAK;EAEvE,OAAO,WAAW,MAAM,MAAM,IAAI,WAAW,OAAO,MAAM;CAC5D,CAAC;AACH"}

package/esm/tooling/inspect/explain-file.d.mts

@@ -0,0 +1,12 @@
+import { InspectFile, InspectPage, InspectReport, InspectRoute } from "./inspect-report.types.mjs";
+//#region ../../packages/core/src/tooling/inspect/explain-file.d.ts
+export type ExplainedFile = InspectFile & {
+  /** Entry points whose static imports transitively reach this file. */
+  routes: InspectRoute[];
+  pages: InspectPage[];
+  warnings: InspectReport["warnings"];
+};
+/** Explain a project-relative or absolute source path against one inspect snapshot. */
+export declare function explainFile(requested: string, report: InspectReport): ExplainedFile;
+//#endregion
+//# sourceMappingURL=explain-file.d.mts.map

package/esm/tooling/inspect/explain-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-file.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/explain-file.ts"],"mappings":";;YAGY,gBAAgB;;EAE1B,QAAQ;EACR,OAAO;EACP,UAAU;;;wBAII,YAAY,mBAAmB,QAAQ,gBAAgB"}

package/esm/tooling/inspect/explain-file.mjs

@@ -0,0 +1,45 @@
+import { projectFile } from "./collect-files.mjs";
+
+//#region ../../packages/core/src/tooling/inspect/explain-file.ts
+/** Explain a project-relative or absolute source path against one inspect snapshot. */
+function explainFile(requested, report) {
+	const requestedFile = projectFile(report.app.root, requested);
+	const files = new Map((report.files ?? []).map((file) => [file.file, file]));
+	const file = files.get(requestedFile);
+	if (!file) throw new Error(`Source file ${JSON.stringify(requested)} was not found under src/.`);
+	const reached = /* @__PURE__ */ new Set();
+	const pending = [file.file];
+	while (pending.length > 0) {
+		const current = pending.pop();
+		if (current === void 0 || reached.has(current)) continue;
+		reached.add(current);
+		pending.push(...files.get(current)?.importedBy ?? []);
+	}
+	const reaches = (entry) => reached.has(projectFile(report.app.root, entry));
+	return {
+		...file,
+		routes: (report.routes ?? []).filter((route) => route.sourceFile !== null && reaches(route.sourceFile)),
+		pages: (report.pages ?? []).filter((page) => [
+			page.file,
+			...page.layouts,
+			...page.loaders
+		].some(reaches)),
+		warnings: report.warnings
+	};
+}
+function formatFileExplanation(file) {
+	return [
+		`${file.file}  (${file.role})`,
+		`  Module: ${file.module}`,
+		`  Exports: ${file.exports.join(", ") || "none"}`,
+		`  Imports: ${file.imports.map((entry) => entry.file ?? entry.specifier).join(", ") || "none"}`,
+		`  Imported by: ${file.importedBy.join(", ") || "none"}`,
+		`  Routes: ${file.routes.map((route) => `${route.method} ${route.path}`).join(", ") || "none"}`,
+		`  Pages: ${file.pages.map((page) => page.path).join(", ") || "none"}`,
+		...file.warnings.map((warning) => `  Warning: ${warning.message}`)
+	];
+}
+
+//#endregion
+export { explainFile, formatFileExplanation };
+//# sourceMappingURL=explain-file.mjs.map

package/esm/tooling/inspect/explain-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-file.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/explain-file.ts"],"sourcesContent":["import type { InspectFile, InspectPage, InspectReport, InspectRoute } from \"./inspect-report.types\";\nimport { projectFile } from \"./collect-files\";\n\nexport type ExplainedFile = InspectFile & {\n  /** Entry points whose static imports transitively reach this file. */\n  routes: InspectRoute[];\n  pages: InspectPage[];\n  warnings: InspectReport[\"warnings\"];\n};\n\n/** Explain a project-relative or absolute source path against one inspect snapshot. */\nexport function explainFile(requested: string, report: InspectReport): ExplainedFile {\n  const requestedFile = projectFile(report.app.root, requested);\n  const files = new Map((report.files ?? []).map((file) => [file.file, file]));\n  const file = files.get(requestedFile);\n  if (!file) throw new Error(`Source file ${JSON.stringify(requested)} was not found under src/.`);\n\n  // Walk reverse edges once, including cycles and the entry point itself.\n  const reached = new Set<string>();\n  const pending = [file.file];\n  while (pending.length > 0) {\n    const current = pending.pop();\n    if (current === undefined || reached.has(current)) continue;\n    reached.add(current);\n    pending.push(...(files.get(current)?.importedBy ?? []));\n  }\n  const reaches = (entry: string): boolean => reached.has(projectFile(report.app.root, entry));\n  return {\n    ...file,\n    routes: (report.routes ?? []).filter(\n      (route) => route.sourceFile !== null && reaches(route.sourceFile),\n    ),\n    pages: (report.pages ?? []).filter((page) =>\n      [page.file, ...page.layouts, ...page.loaders].some(reaches),\n    ),\n    warnings: report.warnings,\n  };\n}\n\nexport function formatFileExplanation(file: ExplainedFile): string[] {\n  return [\n    `${file.file}  (${file.role})`,\n    `  Module: ${file.module}`,\n    `  Exports: ${file.exports.join(\", \") || \"none\"}`,\n    `  Imports: ${file.imports.map((entry) => entry.file ?? entry.specifier).join(\", \") || \"none\"}`,\n    `  Imported by: ${file.importedBy.join(\", \") || \"none\"}`,\n    `  Routes: ${file.routes.map((route) => `${route.method} ${route.path}`).join(\", \") || \"none\"}`,\n    `  Pages: ${file.pages.map((page) => page.path).join(\", \") || \"none\"}`,\n    ...file.warnings.map((warning) => `  Warning: ${warning.message}`),\n  ];\n}\n"],"mappings":";;;;AAWA,SAAgB,YAAY,WAAmB,QAAsC;CACnF,MAAM,gBAAgB,YAAY,OAAO,IAAI,MAAM,SAAS;CAC5D,MAAM,QAAQ,IAAI,KAAK,OAAO,SAAS,CAAC,EAAC,CAAE,KAAK,SAAS,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;CAC3E,MAAM,OAAO,MAAM,IAAI,aAAa;CACpC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,eAAe,KAAK,UAAU,SAAS,EAAE,2BAA2B;CAG/F,MAAM,0BAAU,IAAI,IAAY;CAChC,MAAM,UAAU,CAAC,KAAK,IAAI;CAC1B,OAAO,QAAQ,SAAS,GAAG;EACzB,MAAM,UAAU,QAAQ,IAAI;EAC5B,IAAI,YAAY,UAAa,QAAQ,IAAI,OAAO,GAAG;EACnD,QAAQ,IAAI,OAAO;EACnB,QAAQ,KAAK,GAAI,MAAM,IAAI,OAAO,CAAC,EAAE,cAAc,CAAC,CAAE;CACxD;CACA,MAAM,WAAW,UAA2B,QAAQ,IAAI,YAAY,OAAO,IAAI,MAAM,KAAK,CAAC;CAC3F,OAAO;EACL,GAAG;EACH,SAAS,OAAO,UAAU,CAAC,EAAC,CAAE,QAC3B,UAAU,MAAM,eAAe,QAAQ,QAAQ,MAAM,UAAU,CAClE;EACA,QAAQ,OAAO,SAAS,CAAC,EAAC,CAAE,QAAQ,SAClC;GAAC,KAAK;GAAM,GAAG,KAAK;GAAS,GAAG,KAAK;EAAO,CAAC,CAAC,KAAK,OAAO,CAC5D;EACA,UAAU,OAAO;CACnB;AACF;AAEA,SAAgB,sBAAsB,MAA+B;CACnE,OAAO;EACL,GAAG,KAAK,KAAK,KAAK,KAAK,KAAK;EAC5B,aAAa,KAAK;EAClB,cAAc,KAAK,QAAQ,KAAK,IAAI,KAAK;EACzC,cAAc,KAAK,QAAQ,KAAK,UAAU,MAAM,QAAQ,MAAM,SAAS,CAAC,CAAC,KAAK,IAAI,KAAK;EACvF,kBAAkB,KAAK,WAAW,KAAK,IAAI,KAAK;EAChD,aAAa,KAAK,OAAO,KAAK,UAAU,GAAG,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,CAAC,KAAK,IAAI,KAAK;EACvF,YAAY,KAAK,MAAM,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK;EAC9D,GAAG,KAAK,SAAS,KAAK,YAAY,cAAc,QAAQ,SAAS;CACnE;AACF"}

package/esm/tooling/inspect/index.d.mts

@@ -1,8 +1,9 @@
-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-report.types.mjs";
+import { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, InspectConfigKey, InspectEvent, InspectFile, InspectJob, InspectModel, InspectModelColumn, InspectModelRelation, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema } from "./inspect-report.types.mjs";
 import { EventRecorder, RecordedListener, groupListeners } from "./event-recorder.mjs";
 import { InspectModelModule } from "./collect-models.mjs";
 import { AppModuleImporter } from "./collect-packages.mjs";
 import { InspectOptions, inspectApp, isInspectSection, parseInspectSections } from "./inspect-app.mjs";
 import { InspectBootResult, bootForInspect, inspectOptionsFromBoot } from "./boot-for-inspect.mjs";
 import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect-report.schema.mjs";
-export { type AppModuleImporter, EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, type InspectBootResult, InspectConfigKey, InspectEvent, InspectJob, InspectModel, InspectModelColumn, type InspectModelModule, InspectModelRelation, type InspectOptions, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema, type RecordedListener, bootForInspect, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };
+import { ExplainedFile, explainFile } from "./explain-file.mjs";
+export { type AppModuleImporter, EventRecorder, type ExplainedFile, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, type InspectBootResult, InspectConfigKey, InspectEvent, InspectFile, InspectJob, InspectModel, InspectModelColumn, type InspectModelModule, InspectModelRelation, type InspectOptions, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema, type RecordedListener, bootForInspect, explainFile, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };

package/esm/tooling/inspect/index.mjs

@@ -2,6 +2,7 @@ import { EventRecorder, groupListeners } from "./event-recorder.mjs";
 import { bootForInspect, inspectOptionsFromBoot } from "./boot-for-inspect.mjs";
 import { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS } from "./inspect-report.types.mjs";
 import { inspectApp, isInspectSection, parseInspectSections } from "./inspect-app.mjs";
+import { explainFile } from "./explain-file.mjs";
 import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect-report.schema.mjs";
 
-export { EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, bootForInspect, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };
+export { EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, bootForInspect, explainFile, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };

package/esm/tooling/inspect/inspect-app.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-app.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-app.ts"],"mappings":";;;;;;;YA0BY;;EAEV;;EAEA,oBAAoB;;EAEpB,kBAAkB;;EAElB,wBAAwB;;EAExB,kBAAkB;;EAElB,oBAAoB;;EAEpB;IAA4B;IAAc;;;EAE1C;;;;;EAKA,uBAAuB;;EAEvB,SAAS;;EAET,gBAAgB;;EAEhB,YAAY;;;wBAIE,iBAAiB,gBAAgB,SAAS;;;;;wBAQ1C,qBAAqB,4BAA4B;;;;;;;;;;;;;;wBA+B3C,WAAW,UAAS,iBAAsB,QAAQ"}
+{"version":3,"file":"inspect-app.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-app.ts"],"mappings":";;;;;;;YA2BY;;EAEV;;EAEA,oBAAoB;;EAEpB,kBAAkB;;EAElB,wBAAwB;;EAExB,kBAAkB;;EAElB,oBAAoB;;EAEpB;IAA4B;IAAc;;;EAE1C;;;;;EAKA,uBAAuB;;EAEvB,SAAS;;EAET,gBAAgB;;EAEhB,YAAY;;;wBAIE,iBAAiB,gBAAgB,SAAS;;;;;wBAQ1C,qBAAqB,4BAA4B;;;;;;;;;;;;;;wBA+B3C,WAAW,UAAS,iBAAsB,QAAQ"}

package/esm/tooling/inspect/inspect-app.mjs

@@ -2,6 +2,7 @@ import { Application } from "../../application/application.mjs";
 import { router } from "../../router/router.mjs";
 import { SchemaRegistry } from "../../openapi/schema-registry.mjs";
 import { groupListeners } from "./event-recorder.mjs";
+import { collectFiles } from "./collect-files.mjs";
 import { collectConfig } from "./collect-config.mjs";
 import { collectModels, collectResources } from "./collect-models.mjs";
 import { collectJobs, collectPackages, collectSchedules, createAppModuleImporter, readAppPackage } from "./collect-packages.mjs";
@@ -72,14 +73,19 @@ async function inspectApp(options = {}) {
 		components: { schemas: {} },
 		warnings
 	};
-	const routes = collectRoutes(options.routes ?? router.list(), registry, warnings);
-	const { models, resourceModels } = collectModels(options.modelModules ?? [], registry, warnings);
+	const filesOnly = sections.every((section) => section === "files");
+	const routes = !filesOnly ? collectRoutes(options.routes ?? router.list(), registry, warnings) : [];
+	const { models, resourceModels } = !filesOnly ? collectModels(options.modelModules ?? [], registry, warnings) : {
+		models: [],
+		resourceModels: /* @__PURE__ */ new Map()
+	};
+	if (wants.has("files")) report.files = collectFiles(cwd, warnings);
 	if (wants.has("routes")) report.routes = routes;
 	if (wants.has("models")) report.models = models;
 	if (wants.has("resources")) report.resources = collectResources(registry, resourceModels);
 	if (wants.has("config")) report.config = collectConfig(cwd, options.config);
 	if (wants.has("events")) report.events = groupListeners(options.events ?? []);
-	if (wants.has("pages")) report.pages = collectPages(options.pages ?? installedPagesFromConnectors(), cwd, warnings);
+	if (wants.has("pages")) report.pages = collectPages(options.pages ?? installedPagesFromConnectors(), cwd, warnings, report.files);
 	if (wants.has("jobs")) report.jobs = await collectJobs(importFromApp, warnings);
 	if (wants.has("schedules")) report.schedules = await collectSchedules(importFromApp, warnings);
 	if (wants.has("packages")) report.packages = collectPackages(cwd);