@warlock.js/core 4.4.0 → 4.6.0

package/esm/ai/src/workflow/workflow.mjs

@@ -0,0 +1,122 @@
+import { WorkflowError } from "../errors/workflow-error.mjs";
+import "../errors/index.mjs";
+import { notifyObservers } from "../observe/resolve-observers.mjs";
+import { asTool } from "./as-tool.mjs";
+import { WorkflowEmitter } from "./emitter.mjs";
+import { loadSnapshotForResume } from "./snapshot.mjs";
+import { runWorkflow } from "./engine.mjs";
+import { computeSignature } from "./signature.mjs";
+
+//#region ../@warlock.js/ai/src/workflow/workflow.ts
+/**
+* `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the
+* definition, computes a stable structural signature, and wires up the
+* three-tier event subscription model.
+*/
+function workflow(definition) {
+	validate(definition);
+	const signature = computeSignature(definition);
+	const emitter = new WorkflowEmitter(definition.on);
+	async function execute(inputOrOptions, maybeOptions) {
+		const { input, options } = normalizeExecuteArgs(inputOrOptions, maybeOptions);
+		const runId = options?.runId ?? generateRunId();
+		const result = await runWorkflow({
+			definition,
+			signature,
+			emitter,
+			input,
+			context: options?.context,
+			runId,
+			signal: options?.signal,
+			executionHandlers: options?.on,
+			sessionId: options?.sessionId
+		});
+		await notifyObservers(definition.observe, result.report);
+		return result;
+	}
+	async function resume(runId, options) {
+		const snapshot = await loadSnapshotForResume({
+			definition,
+			signature,
+			runId,
+			options
+		});
+		const result = await runWorkflow({
+			definition,
+			signature,
+			emitter,
+			input: snapshot.input,
+			context: options?.context,
+			runId,
+			signal: options?.signal,
+			executionHandlers: options?.on,
+			sessionId: options?.sessionId,
+			resumeFrom: snapshot
+		});
+		await notifyObservers(definition.observe, result.report);
+		return result;
+	}
+	const instance = {
+		name: definition.name,
+		description: definition.description,
+		inputSchema: definition.inputSchema,
+		signature,
+		version: definition.version,
+		execute,
+		resume,
+		on(event, handler) {
+			return emitter.on(event, handler);
+		},
+		off(event, handler) {
+			emitter.off(event, handler);
+		},
+		asTool(options) {
+			return asTool(instance, options);
+		}
+	};
+	return instance;
+}
+/**
+* Resolve the overloaded `execute()` call shape. If the caller passed
+* a single plain object with an `input` field, treat it as the
+* combined `WorkflowExecuteOptions`. Otherwise the first arg is the
+* raw workflow input and the second is the run options.
+*
+* Ambiguity note: if your real workflow `input` is itself an object
+* with a top-level `input` key, prefer `execute(rawInput, options)`
+* explicitly — the single-arg detection heuristic would mis-classify
+* it.
+*/
+function normalizeExecuteArgs(inputOrOptions, maybeOptions) {
+	if (maybeOptions === void 0 && inputOrOptions !== null && typeof inputOrOptions === "object" && "input" in inputOrOptions) {
+		const { input, ...options } = inputOrOptions;
+		return {
+			input,
+			options
+		};
+	}
+	return {
+		input: inputOrOptions,
+		options: maybeOptions
+	};
+}
+function validate(definition) {
+	if (!definition.name || typeof definition.name !== "string") throw new WorkflowError("ai.workflow: `name` is required");
+	if (!Array.isArray(definition.steps) || definition.steps.length === 0) throw new WorkflowError(`ai.workflow("${definition.name}"): at least one step is required`);
+	const seen = /* @__PURE__ */ new Set();
+	const walk = (name) => {
+		if (seen.has(name)) throw new WorkflowError(`ai.workflow("${definition.name}"): duplicate step name "${name}"`);
+		seen.add(name);
+	};
+	for (const step of definition.steps) {
+		walk(step.name);
+		if (step.parallel) for (const child of step.parallel) walk(child.name);
+	}
+}
+function generateRunId() {
+	return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+
+//#endregion
+export { workflow };
+//# sourceMappingURL=workflow.mjs.map

package/esm/ai/src/workflow/workflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.mjs","names":["combined"],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/workflow.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { ExecutionReport } from \"../contracts/result/execution-report.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandler,\n  WorkflowExecuteOptions,\n  WorkflowInstance,\n  WorkflowResumeOptions,\n  WorkflowRunOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport { notifyObservers } from \"../observe/resolve-observers\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { WorkflowEmitter } from \"./emitter\";\nimport { loadSnapshotForResume, runWorkflow } from \"./engine\";\nimport { computeSignature } from \"./signature\";\n\n/**\n * `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the\n * definition, computes a stable structural signature, and wires up the\n * three-tier event subscription model.\n */\nexport function workflow<\n  TInput = unknown,\n  TOutput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): WorkflowInstance<TInput, TOutput, TState, TContext> {\n  validate(definition);\n  const signature = computeSignature(definition);\n  const emitter = new WorkflowEmitter(definition.on);\n\n  async function execute(\n    inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n    maybeOptions?: WorkflowRunOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const { input, options } = normalizeExecuteArgs<TInput, TContext>(\n      inputOrOptions,\n      maybeOptions,\n    );\n    const runId = options?.runId ?? generateRunId();\n    const result = await runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n    });\n\n    // Route the finished report to any resolved observers (F1/F3).\n    // Gated by `definition.observe` + the global observe-all flag;\n    // observer errors are swallowed inside `notifyObservers`. Bridge the\n    // pre-existing `WorkflowReport = Omit<BaseReport, \"type\">` drift (the\n    // report carries `type: \"workflow\"` at runtime — engine sets it) so\n    // this call site adds no new type error beyond the documented baseline.\n    await notifyObservers(definition.observe, result.report as unknown as ExecutionReport);\n\n    return result;\n  }\n\n  async function resume(\n    runId: string,\n    options?: WorkflowResumeOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      definition,\n      signature,\n      runId,\n      options,\n    });\n\n    const result = await runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input: snapshot.input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n      resumeFrom: snapshot,\n    });\n\n    await notifyObservers(definition.observe, result.report as unknown as ExecutionReport);\n\n    return result;\n  }\n\n  const instance: WorkflowInstance<TInput, TOutput, TState, TContext> = {\n    name: definition.name,\n    description: definition.description,\n    inputSchema: definition.inputSchema,\n    signature,\n    version: definition.version,\n    execute,\n    resume,\n    on<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = TInput>(options: {\n      description?: string;\n      inputSchema: StandardSchemaV1<TToolInput>;\n    }): ToolContract<TToolInput, TOutput> {\n      return asTool<TInput, TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Resolve the overloaded `execute()` call shape. If the caller passed\n * a single plain object with an `input` field, treat it as the\n * combined `WorkflowExecuteOptions`. Otherwise the first arg is the\n * raw workflow input and the second is the run options.\n *\n * Ambiguity note: if your real workflow `input` is itself an object\n * with a top-level `input` key, prefer `execute(rawInput, options)`\n * explicitly — the single-arg detection heuristic would mis-classify\n * it.\n */\nfunction normalizeExecuteArgs<TInput, TContext>(\n  inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n  maybeOptions: WorkflowRunOptions<TContext> | undefined,\n): { input: TInput; options?: WorkflowRunOptions<TContext> } {\n  if (\n    maybeOptions === undefined &&\n    inputOrOptions !== null &&\n    typeof inputOrOptions === \"object\" &&\n    \"input\" in (inputOrOptions as object)\n  ) {\n    const combined = inputOrOptions as WorkflowExecuteOptions<TInput, TContext>;\n    const { input, ...options } = combined;\n    return { input, options };\n  }\n\n  return { input: inputOrOptions as TInput, options: maybeOptions };\n}\n\nfunction validate<TInput, TOutput, TState, TContext>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): void {\n  if (!definition.name || typeof definition.name !== \"string\") {\n    throw new WorkflowError(\"ai.workflow: `name` is required\");\n  }\n\n  if (!Array.isArray(definition.steps) || definition.steps.length === 0) {\n    throw new WorkflowError(`ai.workflow(\"${definition.name}\"): at least one step is required`);\n  }\n\n  const seen = new Set<string>();\n  const walk = (name: string) => {\n    if (seen.has(name)) {\n      throw new WorkflowError(`ai.workflow(\"${definition.name}\"): duplicate step name \"${name}\"`);\n    }\n    seen.add(name);\n  };\n\n  for (const step of definition.steps) {\n    walk(step.name);\n\n    if (step.parallel) {\n      for (const child of step.parallel) {\n        walk(child.name);\n      }\n    }\n  }\n}\n\nfunction generateRunId(): string {\n  // Non-crypto random — adequate for ephemeral workflow runs.\n  return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,SAAgB,SAMd,YACqD;CACrD,SAAS,UAAU;CACnB,MAAM,YAAY,iBAAiB,UAAU;CAC7C,MAAM,UAAU,IAAI,gBAAgB,WAAW,EAAE;CAEjD,eAAe,QACb,gBACA,cACkC;EAClC,MAAM,EAAE,OAAO,YAAY,qBACzB,gBACA,YACF;EACA,MAAM,QAAQ,SAAS,SAAS,cAAc;EAC9C,MAAM,SAAS,MAAM,YAAqB;GACxC;GACA;GACA;GACA;GACA,SAAS,SAAS;GAClB;GACA,QAAQ,SAAS;GACjB,mBAAmB,SAAS;GAC5B,WAAW,SAAS;EACtB,CAAC;EAQD,MAAM,gBAAgB,WAAW,SAAS,OAAO,MAAoC;EAErF,OAAO;CACT;CAEA,eAAe,OACb,OACA,SACkC;EAClC,MAAM,WAAW,MAAM,sBAAsB;GAC3C;GACA;GACA;GACA;EACF,CAAC;EAED,MAAM,SAAS,MAAM,YAAqB;GACxC;GACA;GACA;GACA,OAAO,SAAS;GAChB,SAAS,SAAS;GAClB;GACA,QAAQ,SAAS;GACjB,mBAAmB,SAAS;GAC5B,WAAW,SAAS;GACpB,YAAY;EACd,CAAC;EAED,MAAM,gBAAgB,WAAW,SAAS,OAAO,MAAoC;EAErF,OAAO;CACT;CAEA,MAAM,WAAgE;EACpE,MAAM,WAAW;EACjB,aAAa,WAAW;EACxB,aAAa,WAAW;EACxB;EACA,SAAS,WAAW;EACpB;EACA;EACA,GAAqC,OAAU,SAAkC;GAC/E,OAAO,QAAQ,GAAG,OAAO,OAAO;EAClC;EACA,IAAsC,OAAU,SAAkC;GAChF,QAAQ,IAAI,OAAO,OAAO;EAC5B;EACA,OAA4B,SAGU;GACpC,OAAO,OAAoC,UAAU,OAAO;EAC9D;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAS,qBACP,gBACA,cAC2D;CAC3D,IACE,iBAAiB,UACjB,mBAAmB,QACnB,OAAO,mBAAmB,YAC1B,WAAY,gBACZ;EAEA,MAAM,EAAE,OAAO,GAAG,YAAYA;EAC9B,OAAO;GAAE;GAAO;EAAQ;CAC1B;CAEA,OAAO;EAAE,OAAO;EAA0B,SAAS;CAAa;AAClE;AAEA,SAAS,SACP,YACM;CACN,IAAI,CAAC,WAAW,QAAQ,OAAO,WAAW,SAAS,UACjD,MAAM,IAAI,cAAc,iCAAiC;CAG3D,IAAI,CAAC,MAAM,QAAQ,WAAW,KAAK,KAAK,WAAW,MAAM,WAAW,GAClE,MAAM,IAAI,cAAc,gBAAgB,WAAW,KAAK,kCAAkC;CAG5F,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,QAAQ,SAAiB;EAC7B,IAAI,KAAK,IAAI,IAAI,GACf,MAAM,IAAI,cAAc,gBAAgB,WAAW,KAAK,2BAA2B,KAAK,EAAE;EAE5F,KAAK,IAAI,IAAI;CACf;CAEA,KAAK,MAAM,QAAQ,WAAW,OAAO;EACnC,KAAK,KAAK,IAAI;EAEd,IAAI,KAAK,UACP,KAAK,MAAM,SAAS,KAAK,UACvB,KAAK,MAAM,IAAI;CAGrB;AACF;AAEA,SAAS,gBAAwB;CAE/B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE;AAChF"}

package/esm/ai-openai/src/embedder.mjs

@@ -0,0 +1,4 @@
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/image.mjs

@@ -0,0 +1,5 @@
+import "../../ai/src/index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/index.mjs

@@ -0,0 +1,7 @@
+import "./embedder.mjs";
+import "./image.mjs";
+import "./speech.mjs";
+import "./transcription.mjs";
+import "./sdk.mjs";
+
+export {  };

package/esm/ai-openai/src/model.mjs

@@ -0,0 +1,5 @@
+import "../../ai/src/index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/sdk.mjs

@@ -0,0 +1,9 @@
+import "../../node_modules/openai/index.mjs";
+import "../../ai/src/index.mjs";
+import "./embedder.mjs";
+import "./image.mjs";
+import "./model.mjs";
+import "./speech.mjs";
+import "./transcription.mjs";
+
+export {  };

package/esm/ai-openai/src/speech.mjs

@@ -0,0 +1,5 @@
+import "../../ai/src/index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/transcription.mjs

@@ -0,0 +1,6 @@
+import "../../node_modules/openai/index.mjs";
+import "../../ai/src/index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/utils/index.mjs

@@ -0,0 +1,5 @@
+import "./to-openai-messages.mjs";
+import "./to-openai-tools.mjs";
+import "./wrap-openai-error.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/to-openai-messages.mjs

@@ -0,0 +1,3 @@
+import "../../../ai/src/index.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/to-openai-tools.mjs

@@ -0,0 +1,3 @@
+import "../../../ai/src/index.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/wrap-openai-error.mjs

@@ -0,0 +1,4 @@
+import "../../../node_modules/openai/index.mjs";
+import "../../../ai/src/index.mjs";
+
+export {  };

package/esm/cli/commands/dev-server.command.mjs

@@ -19,7 +19,7 @@ const devServerCommand = command({
 		await displayStartupBanner({ environment: "development" });
 	},
 	action: async (data) => {
-		await startDevelopmentServer({
+		startDevelopmentServer({
 			fresh: Boolean(data.options.fresh),
 			generateTypings: data.options.skipTypings ? false : void 0,
 			healthCheckers: data.options.skipHealth ? false : void 0

package/esm/cli/commands/dev-server.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\r\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\r\nimport { command } from \"../cli-command\";\r\nimport { displayStartupBanner } from \"../cli-commands.utils\";\r\n\r\nexport const devServerCommand = command({\r\n  name: \"dev\",\r\n  description: \"Start development server (HMR, type-gen, health checks)\",\r\n  persistent: true,\r\n  preload: {\r\n    runtimeStrategy: \"development\",\r\n    config: true, // load all config\r\n    bootstrap: true,\r\n    prestart: true, // load prestart file (if exists)\r\n    // Only the Early lifecycle phase starts here; the Late phase\r\n    // (http, socket) starts after app modules load — see\r\n    // development-server.ts STEP 8.5.\r\n    connectors: true,\r\n  },\r\n  preAction: async () => {\r\n    await displayStartupBanner({ environment: \"development\" });\r\n  },\r\n  action: async (data) => {\r\n    await startDevelopmentServer({\r\n      fresh: Boolean(data.options.fresh),\r\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\r\n      // lets `warlock.config.ts > devServer.*` defaults apply.\r\n      generateTypings: data.options.skipTypings ? false : undefined,\r\n      healthCheckers: data.options.skipHealth ? false : undefined,\r\n    });\r\n\r\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\r\n    // a newer @warlock.js/core has been published. Fully self-guarded — it\r\n    // never blocks startup nor breaks dev if the registry is unreachable.\r\n    void checkForFrameworkUpdate();\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-typings, -st\",\r\n      description: \"Skip background type generation for this run\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-health, -sh\",\r\n      description: \"Skip file health checkers for this run\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;;AAKA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EACrB,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EACtB,MAAM,uBAAuB;GAC3B,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;EACpD,CAAC;EAKD,AAAK,wBAAwB;CAC/B;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\r\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\r\nimport { command } from \"../cli-command\";\r\nimport { displayStartupBanner } from \"../cli-commands.utils\";\r\n\r\nexport const devServerCommand = command({\r\n  name: \"dev\",\r\n  description: \"Start development server (HMR, type-gen, health checks)\",\r\n  persistent: true,\r\n  preload: {\r\n    runtimeStrategy: \"development\",\r\n    config: true, // load all config\r\n    bootstrap: true,\r\n    prestart: true, // load prestart file (if exists)\r\n    // Only the Early lifecycle phase starts here; the Late phase\r\n    // (http, socket) starts after app modules load — see\r\n    // development-server.ts STEP 8.5.\r\n    connectors: true,\r\n  },\r\n  preAction: async () => {\r\n    await displayStartupBanner({ environment: \"development\" });\r\n  },\r\n  action: async (data) => {\r\n    startDevelopmentServer({\r\n      fresh: Boolean(data.options.fresh),\r\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\r\n      // lets `warlock.config.ts > devServer.*` defaults apply.\r\n      generateTypings: data.options.skipTypings ? false : undefined,\r\n      healthCheckers: data.options.skipHealth ? false : undefined,\r\n    });\r\n\r\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\r\n    // a newer @warlock.js/core has been published. Fully self-guarded — it\r\n    // never blocks startup nor breaks dev if the registry is unreachable.\r\n    void checkForFrameworkUpdate();\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-typings, -st\",\r\n      description: \"Skip background type generation for this run\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-health, -sh\",\r\n      description: \"Skip file health checkers for this run\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;;AAKA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EACrB,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EACtB,uBAAuB;GACrB,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;EACpD,CAAC;EAKD,AAAK,wBAAwB;CAC/B;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/doctor/checks/config.check.mjs

@@ -0,0 +1,42 @@
+import { config } from "../../../../config/config-getter.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/config.check.ts
+/**
+* Config sections that a typical Warlock HTTP application is expected to
+* register. A missing section here is release/runtime-blocking, so absence is
+* a `fail` rather than a warning.
+*/
+const REQUIRED_CONFIG_SECTIONS = ["app", "http"];
+/**
+* `@mongez/config` returns `null` (not `undefined`) for an unregistered key,
+* so treat both nullish values as "missing".
+*/
+function isPresent(value) {
+	return value !== null && value !== void 0;
+}
+/**
+* Verifies that the required top-level config sections are present. Reads each
+* section via `config.get` only — never mutates configuration.
+*/
+const configCheck = {
+	name: "config",
+	run: () => {
+		const missing = REQUIRED_CONFIG_SECTIONS.filter((section) => {
+			return !isPresent(config.get(section));
+		});
+		if (missing.length > 0) return {
+			name: "config",
+			status: "fail",
+			detail: `missing required config section(s): ${missing.join(", ")}`
+		};
+		return {
+			name: "config",
+			status: "ok",
+			detail: `required sections present (${REQUIRED_CONFIG_SECTIONS.join(", ")})`
+		};
+	}
+};
+
+//#endregion
+export { configCheck };
+//# sourceMappingURL=config.check.mjs.map

package/esm/cli/commands/doctor/checks/config.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/config.check.ts"],"sourcesContent":["import { config } from \"../../../../config/config-getter\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Config sections that a typical Warlock HTTP application is expected to\n * register. A missing section here is release/runtime-blocking, so absence is\n * a `fail` rather than a warning.\n */\nconst REQUIRED_CONFIG_SECTIONS = [\"app\", \"http\"] as const;\n\n/**\n * `@mongez/config` returns `null` (not `undefined`) for an unregistered key,\n * so treat both nullish values as \"missing\".\n */\nfunction isPresent(value: unknown): boolean {\n  return value !== null && value !== undefined;\n}\n\n/**\n * Verifies that the required top-level config sections are present. Reads each\n * section via `config.get` only — never mutates configuration.\n */\nexport const configCheck: DoctorCheck = {\n  name: \"config\",\n  run: () => {\n    const missing = REQUIRED_CONFIG_SECTIONS.filter((section) => {\n      return !isPresent(config.get(section));\n    });\n\n    if (missing.length > 0) {\n      return {\n        name: \"config\",\n        status: \"fail\",\n        detail: `missing required config section(s): ${missing.join(\", \")}`,\n      };\n    }\n\n    return {\n      name: \"config\",\n      status: \"ok\",\n      detail: `required sections present (${REQUIRED_CONFIG_SECTIONS.join(\", \")})`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;AAQA,MAAM,2BAA2B,CAAC,OAAO,MAAM;;;;;AAM/C,SAAS,UAAU,OAAyB;CAC1C,OAAO,UAAU,QAAQ,UAAU;AACrC;;;;;AAMA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,UAAU,yBAAyB,QAAQ,YAAY;GAC3D,OAAO,CAAC,UAAU,OAAO,IAAI,OAAO,CAAC;EACvC,CAAC;EAED,IAAI,QAAQ,SAAS,GACnB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,uCAAuC,QAAQ,KAAK,IAAI;EAClE;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,8BAA8B,yBAAyB,KAAK,IAAI,EAAE;EAC5E;CACF;AACF"}

package/esm/cli/commands/doctor/checks/connectors.check.mjs

@@ -0,0 +1,28 @@
+import { connectorsManager } from "../../../../connectors/connectors-manager.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/connectors.check.ts
+/**
+* Reports which connectors are registered and which are currently active. This
+* is informational: a registered-but-inactive connector is normal (it simply
+* has no config wired), so the check passes as long as the manager can be
+* enumerated and reports its active set.
+*
+* Read-only: calls `connectorsManager.list()` and each connector's
+* `isActive()` (a pure getter) only.
+*/
+const connectorsCheck = {
+	name: "connectors",
+	run: () => {
+		const connectors = connectorsManager.list();
+		const activeNames = connectors.filter((connector) => connector.isActive()).map((connector) => connector.name);
+		return {
+			name: "connectors",
+			status: "ok",
+			detail: activeNames.length > 0 ? `${connectors.length} registered, active: ${activeNames.join(", ")}` : `${connectors.length} registered, none active`
+		};
+	}
+};
+
+//#endregion
+export { connectorsCheck };
+//# sourceMappingURL=connectors.check.mjs.map

package/esm/cli/commands/doctor/checks/connectors.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/connectors.check.ts"],"sourcesContent":["import { connectorsManager } from \"../../../../connectors/connectors-manager\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Reports which connectors are registered and which are currently active. This\n * is informational: a registered-but-inactive connector is normal (it simply\n * has no config wired), so the check passes as long as the manager can be\n * enumerated and reports its active set.\n *\n * Read-only: calls `connectorsManager.list()` and each connector's\n * `isActive()` (a pure getter) only.\n */\nexport const connectorsCheck: DoctorCheck = {\n  name: \"connectors\",\n  run: () => {\n    const connectors = connectorsManager.list();\n    const active = connectors.filter((connector) => connector.isActive());\n    const activeNames = active.map((connector) => connector.name);\n\n    const detail =\n      activeNames.length > 0\n        ? `${connectors.length} registered, active: ${activeNames.join(\", \")}`\n        : `${connectors.length} registered, none active`;\n\n    return {\n      name: \"connectors\",\n      status: \"ok\",\n      detail,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,kBAA+B;CAC1C,MAAM;CACN,WAAW;EACT,MAAM,aAAa,kBAAkB,KAAK;EAE1C,MAAM,cADS,WAAW,QAAQ,cAAc,UAAU,SAAS,CAC1C,CAAC,CAAC,KAAK,cAAc,UAAU,IAAI;EAO5D,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAPA,YAAY,SAAS,IACjB,GAAG,WAAW,OAAO,uBAAuB,YAAY,KAAK,IAAI,MACjE,GAAG,WAAW,OAAO;EAM3B;CACF;AACF"}

package/esm/cli/commands/doctor/checks/health.check.mjs

@@ -0,0 +1,35 @@
+import { config } from "../../../../config/config-getter.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/health.check.ts
+/**
+* Confirms the built-in liveness (`/health`) and readiness (`/ready`)
+* endpoints will be exposed. The HTTP connector registers them automatically
+* unless `http.health.enabled` is explicitly `false`, so this check reads that
+* config flag and the (overridable) paths.
+*
+* Disabling the probes is a deliberate, supported choice but a common
+* misconfiguration in container/orchestrated deployments, so it is surfaced as
+* a `warn` rather than a pass.
+*
+* Read-only: inspects `config.get("http.health")` only.
+*/
+const healthCheck = {
+	name: "health",
+	run: () => {
+		const healthConfig = config.get("http.health");
+		if (healthConfig?.enabled === false) return {
+			name: "health",
+			status: "warn",
+			detail: "health endpoints disabled (http.health.enabled = false)"
+		};
+		return {
+			name: "health",
+			status: "ok",
+			detail: `liveness ${healthConfig?.path ?? "/health"} + readiness ${healthConfig?.readinessPath ?? "/ready"} registered`
+		};
+	}
+};
+
+//#endregion
+export { healthCheck };
+//# sourceMappingURL=health.check.mjs.map

package/esm/cli/commands/doctor/checks/health.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/health.check.ts"],"sourcesContent":["import { config } from \"../../../../config/config-getter\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Confirms the built-in liveness (`/health`) and readiness (`/ready`)\n * endpoints will be exposed. The HTTP connector registers them automatically\n * unless `http.health.enabled` is explicitly `false`, so this check reads that\n * config flag and the (overridable) paths.\n *\n * Disabling the probes is a deliberate, supported choice but a common\n * misconfiguration in container/orchestrated deployments, so it is surfaced as\n * a `warn` rather than a pass.\n *\n * Read-only: inspects `config.get(\"http.health\")` only.\n */\nexport const healthCheck: DoctorCheck = {\n  name: \"health\",\n  run: () => {\n    const healthConfig = config.get(\"http.health\");\n\n    if (healthConfig?.enabled === false) {\n      return {\n        name: \"health\",\n        status: \"warn\",\n        detail: \"health endpoints disabled (http.health.enabled = false)\",\n      };\n    }\n\n    const livenessPath = healthConfig?.path ?? \"/health\";\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\n\n    return {\n      name: \"health\",\n      status: \"ok\",\n      detail: `liveness ${livenessPath} + readiness ${readinessPath} registered`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,eAAe,OAAO,IAAI,aAAa;EAE7C,IAAI,cAAc,YAAY,OAC5B,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAMF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,YANW,cAAc,QAAQ,UAMR,eALb,cAAc,iBAAiB,SAKW;EAChE;CACF;AACF"}

package/esm/cli/commands/doctor/checks/index.mjs

@@ -0,0 +1,25 @@
+import { configCheck } from "./config.check.mjs";
+import { connectorsCheck } from "./connectors.check.mjs";
+import { healthCheck } from "./health.check.mjs";
+import { optionalPeersCheck } from "./optional-peers.check.mjs";
+import { releaseHygieneCheck } from "./release-hygiene.check.mjs";
+import { routesCheck } from "./routes.check.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/index.ts
+/**
+* The default, ordered set of checks `warlock doctor` runs. Ordering controls
+* the report layout: runtime-surface checks first (routes, config, connectors,
+* peers, health), release hygiene last.
+*/
+const defaultDoctorChecks = [
+	routesCheck,
+	configCheck,
+	connectorsCheck,
+	optionalPeersCheck,
+	healthCheck,
+	releaseHygieneCheck
+];
+
+//#endregion
+export { defaultDoctorChecks };
+//# sourceMappingURL=index.mjs.map

package/esm/cli/commands/doctor/checks/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/index.ts"],"sourcesContent":["import type { DoctorCheck } from \"../check.types\";\nimport { configCheck } from \"./config.check\";\nimport { connectorsCheck } from \"./connectors.check\";\nimport { healthCheck } from \"./health.check\";\nimport { optionalPeersCheck } from \"./optional-peers.check\";\nimport { releaseHygieneCheck } from \"./release-hygiene.check\";\nimport { routesCheck } from \"./routes.check\";\n\n/**\n * The default, ordered set of checks `warlock doctor` runs. Ordering controls\n * the report layout: runtime-surface checks first (routes, config, connectors,\n * peers, health), release hygiene last.\n */\nexport const defaultDoctorChecks: DoctorCheck[] = [\n  routesCheck,\n  configCheck,\n  connectorsCheck,\n  optionalPeersCheck,\n  healthCheck,\n  releaseHygieneCheck,\n];\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,sBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;AACF"}

package/esm/cli/commands/doctor/checks/optional-peers.check.mjs

@@ -0,0 +1,90 @@
+import { createRequire } from "node:module";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/optional-peers.check.ts
+/**
+* The optional peers core knows how to use. Kept in sync with the install
+* targets in the `warlock add` feature registry (sharp, nodemailer, socket.io,
+* the AWS SDK family, redis, the Cascade DB drivers, …).
+*/
+const OPTIONAL_PEERS = [
+	{
+		package: "sharp",
+		feature: "image processing"
+	},
+	{
+		package: "nodemailer",
+		feature: "mail (SMTP) channel"
+	},
+	{
+		package: "socket.io",
+		feature: "realtime socket server"
+	},
+	{
+		package: "@aws-sdk/client-s3",
+		feature: "S3 cloud storage"
+	},
+	{
+		package: "@aws-sdk/client-sesv2",
+		feature: "Amazon SES mail channel"
+	},
+	{
+		package: "redis",
+		feature: "Redis cache driver"
+	},
+	{
+		package: "mongodb",
+		feature: "MongoDB database driver"
+	},
+	{
+		package: "pg",
+		feature: "Postgres database driver"
+	},
+	{
+		package: "mysql2",
+		feature: "MySQL database driver"
+	}
+];
+/**
+* Resolve from the project's working directory, not from core's own
+* `node_modules`, so the probe reflects what the *consuming app* has installed.
+*/
+const projectRequire = createRequire(`${process.cwd()}/package.json`);
+/**
+* Whether a package can be resolved from the project. A failed resolve (the
+* normal "not installed" case) is swallowed and reported as missing.
+*/
+function isInstalled(packageName) {
+	try {
+		projectRequire.resolve(packageName);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Detects which optional peer dependencies are installed and which are not,
+* reporting the features that are consequently unavailable. Missing peers are
+* a `warn` (the feature is simply off), never a `fail`.
+*
+* Read-only: resolves module paths only; never imports or executes the peers.
+*/
+const optionalPeersCheck = {
+	name: "optional-peers",
+	run: () => {
+		const missing = OPTIONAL_PEERS.filter((peer) => !isInstalled(peer.package));
+		if (missing.length === 0) return {
+			name: "optional-peers",
+			status: "ok",
+			detail: `all ${OPTIONAL_PEERS.length} known optional peers installed`
+		};
+		return {
+			name: "optional-peers",
+			status: "warn",
+			detail: `not installed → unavailable: ${missing.map((peer) => `${peer.package} (${peer.feature})`).join("; ")}`
+		};
+	}
+};
+
+//#endregion
+export { optionalPeersCheck };
+//# sourceMappingURL=optional-peers.check.mjs.map

package/esm/cli/commands/doctor/checks/optional-peers.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-peers.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/optional-peers.check.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * A single optional peer dependency and the feature it unlocks. These are NOT\n * bundled by core — each is loaded lazily by the connector/driver that needs\n * it, so a missing peer simply means that feature is unavailable (a `warn`),\n * never a failure.\n */\ntype OptionalPeer = {\n  /** The npm package name to probe via `require.resolve`. */\n  package: string;\n\n  /** The framework feature this peer enables. */\n  feature: string;\n};\n\n/**\n * The optional peers core knows how to use. Kept in sync with the install\n * targets in the `warlock add` feature registry (sharp, nodemailer, socket.io,\n * the AWS SDK family, redis, the Cascade DB drivers, …).\n */\nconst OPTIONAL_PEERS: OptionalPeer[] = [\n  { package: \"sharp\", feature: \"image processing\" },\n  { package: \"nodemailer\", feature: \"mail (SMTP) channel\" },\n  { package: \"socket.io\", feature: \"realtime socket server\" },\n  { package: \"@aws-sdk/client-s3\", feature: \"S3 cloud storage\" },\n  { package: \"@aws-sdk/client-sesv2\", feature: \"Amazon SES mail channel\" },\n  { package: \"redis\", feature: \"Redis cache driver\" },\n  { package: \"mongodb\", feature: \"MongoDB database driver\" },\n  { package: \"pg\", feature: \"Postgres database driver\" },\n  { package: \"mysql2\", feature: \"MySQL database driver\" },\n];\n\n/**\n * Resolve from the project's working directory, not from core's own\n * `node_modules`, so the probe reflects what the *consuming app* has installed.\n */\nconst projectRequire = createRequire(`${process.cwd()}/package.json`);\n\n/**\n * Whether a package can be resolved from the project. A failed resolve (the\n * normal \"not installed\" case) is swallowed and reported as missing.\n */\nfunction isInstalled(packageName: string): boolean {\n  try {\n    projectRequire.resolve(packageName);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Detects which optional peer dependencies are installed and which are not,\n * reporting the features that are consequently unavailable. Missing peers are\n * a `warn` (the feature is simply off), never a `fail`.\n *\n * Read-only: resolves module paths only; never imports or executes the peers.\n */\nexport const optionalPeersCheck: DoctorCheck = {\n  name: \"optional-peers\",\n  run: () => {\n    const missing = OPTIONAL_PEERS.filter((peer) => !isInstalled(peer.package));\n\n    if (missing.length === 0) {\n      return {\n        name: \"optional-peers\",\n        status: \"ok\",\n        detail: `all ${OPTIONAL_PEERS.length} known optional peers installed`,\n      };\n    }\n\n    const unavailable = missing\n      .map((peer) => `${peer.package} (${peer.feature})`)\n      .join(\"; \");\n\n    return {\n      name: \"optional-peers\",\n      status: \"warn\",\n      detail: `not installed → unavailable: ${unavailable}`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;AAsBA,MAAM,iBAAiC;CACrC;EAAE,SAAS;EAAS,SAAS;CAAmB;CAChD;EAAE,SAAS;EAAc,SAAS;CAAsB;CACxD;EAAE,SAAS;EAAa,SAAS;CAAyB;CAC1D;EAAE,SAAS;EAAsB,SAAS;CAAmB;CAC7D;EAAE,SAAS;EAAyB,SAAS;CAA0B;CACvE;EAAE,SAAS;EAAS,SAAS;CAAqB;CAClD;EAAE,SAAS;EAAW,SAAS;CAA0B;CACzD;EAAE,SAAS;EAAM,SAAS;CAA2B;CACrD;EAAE,SAAS;EAAU,SAAS;CAAwB;AACxD;;;;;AAMA,MAAM,iBAAiB,cAAc,GAAG,QAAQ,IAAI,EAAE,cAAc;;;;;AAMpE,SAAS,YAAY,aAA8B;CACjD,IAAI;EACF,eAAe,QAAQ,WAAW;EAClC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;AASA,MAAa,qBAAkC;CAC7C,MAAM;CACN,WAAW;EACT,MAAM,UAAU,eAAe,QAAQ,SAAS,CAAC,YAAY,KAAK,OAAO,CAAC;EAE1E,IAAI,QAAQ,WAAW,GACrB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,OAAO,eAAe,OAAO;EACvC;EAOF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,gCAPU,QACjB,KAAK,SAAS,GAAG,KAAK,QAAQ,IAAI,KAAK,QAAQ,EAAE,CAAC,CAClD,KAAK,IAK4C;EACpD;CACF;AACF"}

package/esm/cli/commands/doctor/checks/release-hygiene.check.mjs

@@ -0,0 +1,69 @@
+import { rootPath } from "../../../../utils/paths.mjs";
+import { existsSync, readFileSync } from "node:fs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/release-hygiene.check.ts
+/**
+* Parse the top-most `## x.y.z[ - YYYY-MM-DD]` heading out of a CHANGELOG body.
+* Returns `undefined` when no version heading is present.
+*/
+function parseTopHeading(changelog) {
+	const match = changelog.match(/^##\s+(\d+)\.(\d+)\.(\d+)(?:\s*[-–]\s*(\d{4}-\d{2}-\d{2}))?\s*$/m);
+	if (!match) return;
+	const [, major, minor, patch, date] = match;
+	return {
+		version: `${major}.${minor}.${patch}`,
+		date
+	};
+}
+/**
+* Checks that the project's `package.json` version matches the top-most
+* `## x.y.z` heading in `CHANGELOG.md` — the same version↔changelog invariant
+* the release-hygiene unit guard enforces, surfaced as a pre-release doctor
+* check.
+*
+* Verdicts:
+* - no `CHANGELOG.md` → `warn` (a changelog is recommended, not mandatory);
+* - no parseable heading → `warn`;
+* - heading version ≠ package.json version → `fail`;
+* - otherwise → `ok`.
+*
+* Read-only: reads `package.json` and `CHANGELOG.md` from the project root.
+*/
+const releaseHygieneCheck = {
+	name: "release-hygiene",
+	run: () => {
+		const packageJsonPath = rootPath("package.json");
+		const changelogPath = rootPath("CHANGELOG.md");
+		const pkgVersion = JSON.parse(readFileSync(packageJsonPath, "utf8")).version;
+		if (typeof pkgVersion !== "string") return {
+			name: "release-hygiene",
+			status: "fail",
+			detail: "package.json has no string version field"
+		};
+		if (!existsSync(changelogPath)) return {
+			name: "release-hygiene",
+			status: "warn",
+			detail: `no CHANGELOG.md at project root (package.json is ${pkgVersion})`
+		};
+		const heading = parseTopHeading(readFileSync(changelogPath, "utf8"));
+		if (!heading) return {
+			name: "release-hygiene",
+			status: "warn",
+			detail: "CHANGELOG.md has no parseable `## x.y.z` heading"
+		};
+		if (heading.version !== pkgVersion) return {
+			name: "release-hygiene",
+			status: "fail",
+			detail: `package.json ${pkgVersion} ≠ top CHANGELOG heading ${heading.version}`
+		};
+		return {
+			name: "release-hygiene",
+			status: "ok",
+			detail: `package.json and CHANGELOG agree on ${pkgVersion}`
+		};
+	}
+};
+
+//#endregion
+export { releaseHygieneCheck };
+//# sourceMappingURL=release-hygiene.check.mjs.map

package/esm/cli/commands/doctor/checks/release-hygiene.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-hygiene.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/release-hygiene.check.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { rootPath } from \"../../../../utils/paths\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * A `## x.y.z` changelog heading with an optional ` - YYYY-MM-DD` suffix.\n * Mirrors the shape parsed by the tier-0 release-hygiene unit guard; inlined\n * here because that guard lives in the test tree and is not importable from\n * `src`.\n */\ntype ChangelogHeading = {\n  version: string;\n  date?: string;\n};\n\n/**\n * Parse the top-most `## x.y.z[ - YYYY-MM-DD]` heading out of a CHANGELOG body.\n * Returns `undefined` when no version heading is present.\n */\nfunction parseTopHeading(changelog: string): ChangelogHeading | undefined {\n  const match = changelog.match(\n    /^##\\s+(\\d+)\\.(\\d+)\\.(\\d+)(?:\\s*[-–]\\s*(\\d{4}-\\d{2}-\\d{2}))?\\s*$/m,\n  );\n\n  if (!match) {\n    return undefined;\n  }\n\n  const [, major, minor, patch, date] = match;\n\n  return {\n    version: `${major}.${minor}.${patch}`,\n    date,\n  };\n}\n\n/**\n * Checks that the project's `package.json` version matches the top-most\n * `## x.y.z` heading in `CHANGELOG.md` — the same version↔changelog invariant\n * the release-hygiene unit guard enforces, surfaced as a pre-release doctor\n * check.\n *\n * Verdicts:\n * - no `CHANGELOG.md` → `warn` (a changelog is recommended, not mandatory);\n * - no parseable heading → `warn`;\n * - heading version ≠ package.json version → `fail`;\n * - otherwise → `ok`.\n *\n * Read-only: reads `package.json` and `CHANGELOG.md` from the project root.\n */\nexport const releaseHygieneCheck: DoctorCheck = {\n  name: \"release-hygiene\",\n  run: () => {\n    const packageJsonPath = rootPath(\"package.json\");\n    const changelogPath = rootPath(\"CHANGELOG.md\");\n\n    const pkgVersion: unknown = JSON.parse(readFileSync(packageJsonPath, \"utf8\")).version;\n\n    if (typeof pkgVersion !== \"string\") {\n      return {\n        name: \"release-hygiene\",\n        status: \"fail\",\n        detail: \"package.json has no string version field\",\n      };\n    }\n\n    if (!existsSync(changelogPath)) {\n      return {\n        name: \"release-hygiene\",\n        status: \"warn\",\n        detail: `no CHANGELOG.md at project root (package.json is ${pkgVersion})`,\n      };\n    }\n\n    const changelog = readFileSync(changelogPath, \"utf8\");\n    const heading = parseTopHeading(changelog);\n\n    if (!heading) {\n      return {\n        name: \"release-hygiene\",\n        status: \"warn\",\n        detail: \"CHANGELOG.md has no parseable `## x.y.z` heading\",\n      };\n    }\n\n    if (heading.version !== pkgVersion) {\n      return {\n        name: \"release-hygiene\",\n        status: \"fail\",\n        detail: `package.json ${pkgVersion} ≠ top CHANGELOG heading ${heading.version}`,\n      };\n    }\n\n    return {\n      name: \"release-hygiene\",\n      status: \"ok\",\n      detail: `package.json and CHANGELOG agree on ${pkgVersion}`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;AAmBA,SAAS,gBAAgB,WAAiD;CACxE,MAAM,QAAQ,UAAU,MACtB,kEACF;CAEA,IAAI,CAAC,OACH;CAGF,MAAM,GAAG,OAAO,OAAO,OAAO,QAAQ;CAEtC,OAAO;EACL,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG;EAC9B;CACF;AACF;;;;;;;;;;;;;;;AAgBA,MAAa,sBAAmC;CAC9C,MAAM;CACN,WAAW;EACT,MAAM,kBAAkB,SAAS,cAAc;EAC/C,MAAM,gBAAgB,SAAS,cAAc;EAE7C,MAAM,aAAsB,KAAK,MAAM,aAAa,iBAAiB,MAAM,CAAC,CAAC,CAAC;EAE9E,IAAI,OAAO,eAAe,UACxB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAGF,IAAI,CAAC,WAAW,aAAa,GAC3B,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,oDAAoD,WAAW;EACzE;EAIF,MAAM,UAAU,gBADE,aAAa,eAAe,MACN,CAAC;EAEzC,IAAI,CAAC,SACH,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAGF,IAAI,QAAQ,YAAY,YACtB,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,gBAAgB,WAAW,2BAA2B,QAAQ;EACxE;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,uCAAuC;EACjD;CACF;AACF"}

package/esm/cli/commands/doctor/checks/routes.check.mjs

@@ -0,0 +1,30 @@
+import { router } from "../../../../router/router.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/doctor/checks/routes.check.ts
+/**
+* Reports the number of registered routes. A booted app with zero routes
+* almost always means a route module failed to register silently, so this
+* warns (rather than passing) when the route table is empty.
+*
+* Read-only: introspects the router via `routeCount()` only.
+*/
+const routesCheck = {
+	name: "routes",
+	run: () => {
+		const count = router.routeCount();
+		if (count === 0) return {
+			name: "routes",
+			status: "warn",
+			detail: "0 routes registered — did a route module fail to load?"
+		};
+		return {
+			name: "routes",
+			status: "ok",
+			detail: `${count} registered`
+		};
+	}
+};
+
+//#endregion
+export { routesCheck };
+//# sourceMappingURL=routes.check.mjs.map

package/esm/cli/commands/doctor/checks/routes.check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.check.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/doctor/checks/routes.check.ts"],"sourcesContent":["import { router } from \"../../../../router/router\";\nimport type { DoctorCheck } from \"../check.types\";\n\n/**\n * Reports the number of registered routes. A booted app with zero routes\n * almost always means a route module failed to register silently, so this\n * warns (rather than passing) when the route table is empty.\n *\n * Read-only: introspects the router via `routeCount()` only.\n */\nexport const routesCheck: DoctorCheck = {\n  name: \"routes\",\n  run: () => {\n    const count = router.routeCount();\n\n    if (count === 0) {\n      return {\n        name: \"routes\",\n        status: \"warn\",\n        detail: \"0 routes registered — did a route module fail to load?\",\n      };\n    }\n\n    return {\n      name: \"routes\",\n      status: \"ok\",\n      detail: `${count} registered`,\n    };\n  },\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAA2B;CACtC,MAAM;CACN,WAAW;EACT,MAAM,QAAQ,OAAO,WAAW;EAEhC,IAAI,UAAU,GACZ,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACV;EAGF,OAAO;GACL,MAAM;GACN,QAAQ;GACR,QAAQ,GAAG,MAAM;EACnB;CACF;AACF"}