@eventcatalog/core 5.9.0 → 5.9.1

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,8 +1,8 @@
 import {
   raiseEvent
-} from "../chunk-26C26LFE.js";
+} from "../chunk-YBM7MCOY.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-C4L6B5KR.js";
+import "../chunk-KGFAIGOT.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -169,7 +169,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,12 +1,12 @@
 import {
   log_build_default
-} from "../chunk-WN6ZFSXF.js";
+} from "../chunk-3PWCUWQC.js";
 import "../chunk-AD7CL772.js";
-import "../chunk-26C26LFE.js";
+import "../chunk-YBM7MCOY.js";
 import "../chunk-YRZK7HKX.js";
 import "../chunk-CA6WCQ2T.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-C4L6B5KR.js";
+import "../chunk-KGFAIGOT.js";
 import "../chunk-4G7FSRPN.js";
 export {
   log_build_default as default

package/dist/{chunk-WN6ZFSXF.js → chunk-3PWCUWQC.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AD7CL772.js";
 import {
   raiseEvent
-} from "./chunk-26C26LFE.js";
+} from "./chunk-YBM7MCOY.js";
 import {
   countResources,
   hashCatalogContent,

package/dist/{chunk-UIJUSHOT.js → chunk-A3256YCN.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-SZU7I2PD.js";
+} from "./chunk-JDSFD7IC.js";
 import {
   cleanup,
   getEventCatalogConfigFile
@@ -8,6 +8,7 @@ import {
 
 // src/generate.js
 import path from "path";
+import { pathToFileURL } from "url";
 function getDefaultExport(importedModule) {
   if (importedModule === null || typeof importedModule !== "object") {
     throw new Error("Invalid module");
@@ -39,7 +40,7 @@ var generate = async (PROJECT_DIRECTORY) => {
         plugin = plugin.replace("<rootDir>", PROJECT_DIRECTORY);
       }
       try {
-        const importedGenerator = await import(plugin);
+        const importedGenerator = await (path.isAbsolute(plugin) ? import(pathToFileURL(plugin).href) : import(plugin));
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {

package/dist/{chunk-SZU7I2PD.js → chunk-JDSFD7IC.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-C4L6B5KR.js";
+} from "./chunk-KGFAIGOT.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-C4L6B5KR.js → chunk-KGFAIGOT.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/{chunk-26C26LFE.js → chunk-YBM7MCOY.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CPW6G62V.js";
 import {
   VERSION
-} from "./chunk-C4L6B5KR.js";
+} from "./chunk-KGFAIGOT.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-C4L6B5KR.js";
+} from "./chunk-KGFAIGOT.js";
 export {
   VERSION
 };

package/dist/docs/development/00-why-eventcatalog.md

@@ -45,6 +45,9 @@ EventCatalog is technology agnostic, this means you can document and model any s
 - **Help you detect breaking changes before they reach production**
   - Use EventCatalog Agents to [detect breaking schema changes](/docs/development/agents/set-up-breaking-changes)
   - Bring your own model and get notified when things break
+- **Help you follow the architecture decisions you've made**
+  - Document decisions as [ADRs](/docs/development/guides/resources/adrs/introduction) alongside the resources they affect
+  - Use EventCatalog Agents to [check pull requests against your ADRs](/docs/development/agents/set-up-adr-compliance)
 - **Use natural language to query your architecture**
   - Connect AI tools to your architecture using [EventCatalog's MCP server](/docs/development/ask-your-architecture/mcp-server/introduction)
   - Ask architectural questions grounded in your documented domains, services, events, [data products](/docs/development/guides/resources/data-products/introduction), and schemas

package/dist/docs/development/ask-your-architecture/01-intro.md

@@ -9,14 +9,27 @@ description: Architecture documentation for humans and AI
 
 import AddedIn from '@site/src/components/MDX/AddedIn';
 
-EventCatalog creates an internal graph of your architecture. Perfect for AI and LLMs.
+There are three ways to use AI with your catalog.
 
-EventCatalog supports eight ways to use AI with your catalog:
+## Ask questions about your architecture
+
+Connect AI to your catalog, and ask it how your architecture works.
 
 - [EventCatalog MCP Server](/docs/development/ask-your-architecture/mcp-server/introduction) - Connect EventCatalog to Agents through MCP
 - [EventCatalog Assistant](/docs/development/ask-your-architecture/eventcatalog-assistant/what-is-eventcatalog-assistant) - AI Chat in your Catalog.
-- [Sync docs with your code](/docs/development/agents/set-up-code-to-docs) - EventCatalog Agents keep your catalog in sync with your code
-- [Catch breaking changes](/docs/development/agents/set-up-breaking-changes) - EventCatalog Agents warn you before a schema change breaks a consumer
+
+## Automate your pull requests
+
+EventCatalog Agents run in your CI/CD pipeline and report back on your pull requests.
+
+- [Sync docs with your code](/docs/development/agents/set-up-code-to-docs) - Keep your catalog in sync with your code
+- [Catch breaking changes](/docs/development/agents/set-up-breaking-changes) - Get warned before a schema change breaks a consumer
+- [Check code against ADRs](/docs/development/agents/set-up-adr-compliance) - Check that pull requests follow your architecture decisions
+
+## Help AI tools work with your catalog
+
+Give the AI tools you already use the skills and context they need.
+
 - [AI Skills](/docs/development/getting-started/install-skills) - Install our Skills to help you manage your catalog
 - [llms.txt](/docs/development/developer-tools/llms.txt) - Give AI tools a machine-readable index of your catalog.
 - [schemas.txt](/docs/development/developer-tools/schemas.txt) - Give AI tools access to your schemas and specifications.

package/dist/docs/development/ask-your-architecture/06-sync-docs-with-your-code.md

@@ -45,7 +45,7 @@ You need:
 - A repository with code to document (the **source repository**).
 - An API key for an AI model provider.
 
-## Set it up
+## Setup
 
 In your source repository, add two secrets under **Settings → Secrets and variables → Actions**:
 
@@ -75,11 +75,18 @@ jobs:
           fetch-depth: 0
       - uses: event-catalog/agents@v2
         env:
+          # The key for your model's provider. This one is for the default model.
+          # Using another provider? Swap this variable and set `model` below.
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         with:
+          # The agent workflow to run.
           agent: code-to-docs
+          # Your catalog repository, in owner/repo format.
           catalog-repo: your-org/your-catalog
+          # A token that can read your catalog, push branches and open pull requests.
           catalog-token: ${{ secrets.EVENTCATALOG_TOKEN }}
+          # Optional: the model to use. Defaults to anthropic/claude-sonnet-4-6.
+          # model: openai/gpt-5.1
 ```
 
 Replace `your-org/your-catalog` with your catalog repository. Keep `fetch-depth: 0`: the agent needs it to compare the pull request with its base branch.

package/dist/docs/development/ask-your-architecture/07-catch-breaking-changes.md

@@ -40,7 +40,7 @@ You need:
 - A repository with message schemas (the **source repository**).
 - An API key for an AI model provider.
 
-## Set it up
+## Setup
 
 In your source repository, add two secrets under **Settings → Secrets and variables → Actions**:
 
@@ -68,11 +68,18 @@ jobs:
           fetch-depth: 0
       - uses: event-catalog/agents@v2
         env:
+          # The key for your model's provider. This one is for the default model.
+          # Using another provider? Swap this variable and set `model` below.
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         with:
+          # The agent workflow to run.
           agent: breaking-changes
+          # Your catalog repository, in owner/repo format.
           catalog-repo: your-org/your-catalog
+          # A token that can read your catalog repository.
           catalog-token: ${{ secrets.EVENTCATALOG_TOKEN }}
+          # Optional: the model to use. Defaults to anthropic/claude-sonnet-4-6.
+          # model: openai/gpt-5.1
 ```
 
 Replace `your-org/your-catalog` with your catalog repository. Keep `fetch-depth: 0`: the agent needs it to compare the pull request with its base branch.

package/dist/docs/development/ask-your-architecture/08-check-code-against-adrs.md

@@ -0,0 +1,169 @@
+---
+sidebar_position: 8
+keywords:
+  - ADR Compliance
+  - EventCatalog Agents
+  - architecture decision records
+  - ADR governance
+  - GitHub Actions
+sidebar_label: Check code against ADRs
+title: Check code against ADRs
+description: The ADR Compliance workflow comments on pull requests when the code conflicts with an architecture decision documented in your EventCatalog, citing the line and the decision.
+slug: /development/agents/set-up-adr-compliance
+---
+
+import { AdrComplianceComment } from '@site/src/components/AgentOutputs';
+import { AgentPrompt } from '@site/src/components/AgentPrompt';
+
+The **ADR Compliance** workflow checks the code changed in a pull request against the [architecture decision records](/docs/development/guides/resources/adrs/introduction) in your catalog. You choose which ADRs apply to the repository. If the code clearly conflicts with one, it comments with the line, the decision, and how to fix it. It never edits your catalog or blocks a merge.
+
+<AgentPrompt variant="adr-compliance" />
+
+### Example 
+<AdrComplianceComment />
+
+## How it works
+
+1. **Selects the ADRs.** It finds the ADRs matching your `adrs` input, and keeps the `accepted` ones at their latest version. If an accepted ADR amends one of them, it's included too, because the decision can't be judged correctly without it.
+2. **Finds the relevant ones.** It compares the ADR summaries with the changes, so only ADRs on the same topic are reviewed in full.
+3. **Reviews the changed lines.** It reports only clear conflicts. Code that follows an ADR, code the pull request didn't change, and comments that merely mention something an ADR rules out are not conflicts. A decision for a domain or system takes precedence over a broader one on the same topic.
+4. **Checks its citations.** The line must be one the pull request changed, and the quoted sentence must be in the ADR. A conflict that fails this check is dropped.
+5. **Comments on the pull request** with each conflict. The comment updates on every push, and says so once the conflicts are gone.
+
+If there are no conflicts, it doesn't comment.
+
+## Before you start
+
+You need:
+
+- An EventCatalog in a GitHub repository (the **catalog repository**), with the catalog at the root of the repository, and your decisions documented as [ADRs](/docs/development/guides/resources/adrs/creating-adrs).
+- A repository with the code you want to check (the **source repository**).
+- An API key for an AI model provider.
+
+## Setup
+
+In your source repository, add two secrets under **Settings → Secrets and variables → Actions**:
+
+- `ANTHROPIC_API_KEY`, or the key for [your model provider](#models).
+- `EVENTCATALOG_TOKEN`, a GitHub token that can read your catalog repository. The workflow never writes to it.
+
+Then add the workflow. It runs while the pull request is open, so a conflict is raised while the code can still change:
+
+```yaml title=".github/workflows/eventcatalog-adr-compliance.yml"
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  adr-compliance:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+      - uses: event-catalog/agents@v2
+        env:
+          # The key for your model's provider. This one is for the default model.
+          # Using another provider? Swap this variable and set `model` below.
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+        with:
+          # The agent workflow to run.
+          agent: adr-compliance
+          # The ADRs to check against, as globs from your catalog's root.
+          # Here: the top-level adrs folder and the Orders domain.
+          adrs: adrs/**, domains/Orders/**
+          # Your catalog repository, in owner/repo format.
+          catalog-repo: your-org/your-catalog
+          # A token that can read your catalog repository.
+          catalog-token: ${{ secrets.EVENTCATALOG_TOKEN }}
+          # Optional: the model to use. Defaults to anthropic/claude-sonnet-4-6.
+          # model: openai/gpt-5.1
+```
+
+Replace `your-org/your-catalog` with your catalog repository, and set `adrs` to the [ADRs that apply to this repository](#choose-which-adrs-to-check). Keep `fetch-depth: 0`: the agent needs it to compare the pull request with its base branch.
+
+To check it works, open a pull request that does something one of your accepted ADRs rules out.
+
+## Choose which ADRs to check
+
+The `adrs` input is required. It takes comma-separated globs, relative to the root of your catalog. ADRs can live in any `adrs` folder in your catalog, so point the globs at wherever yours are:
+
+| To check against | Use |
+| --- | --- |
+| ADRs in the top-level `adrs` folder | `adrs/**` |
+| A domain, and everything nested in it | `domains/Orders/**` |
+| One system | `domains/Orders/systems/checkout-system/**` |
+| One service | `domains/Orders/services/OrdersAPI/**` |
+| ADRs that share a naming convention | `adrs/adr-orders-*/**` |
+| One ADR | `adrs/adr-012-use-outbox` |
+| Every ADR in the catalog | `'**/adrs/**'` |
+
+A typical repository checks against your organization-wide ADRs and those of its own domain:
+
+```yaml
+with:
+  adrs: adrs/**, domains/Orders/**
+```
+
+Globs start at the catalog root, so `adrs/**` means only the top-level folder, not every folder called `adrs`. A value that starts with `*` needs quotes in YAML.
+
+If `adrs` is missing or matches no ADRs, the run fails with an error that shows where your ADRs are, so a typo can't look like a clean pass.
+
+:::tip
+Checking every ADR in the catalog can raise conflicts with decisions meant for other teams. Start with the ADRs that apply to the repository.
+:::
+
+## Record an exception
+
+If a conflict is intentional, add a line to the pull request description with the ADR's `id` and your reason:
+
+```text
+adr-exception: adr-003-offload-async-work-to-worker small thumbnails only
+```
+
+The conflict then moves to an exceptions list in the comment, so reviewers can still see it. The agent reads the description when it runs, so push a commit or re-run the workflow after adding the line. To re-run automatically when the description changes, add `edited` to the `types`.
+
+A reason is required: a line without one is ignored. Exceptions are visible rather than enforced, so anyone who can edit the description can add one.
+
+If the decision itself has changed, propose a new ADR in your catalog instead. See [ADR relationships](/docs/development/guides/resources/adrs/relationships).
+
+## Configuration
+
+| Input | Required | Default | Description |
+| --- | --- | --- | --- |
+| `agent` | Yes | | Set to `adr-compliance` to run this workflow. |
+| `adrs` | Yes | | Comma-separated globs, relative to the catalog root, selecting the ADRs to check against. |
+| `catalog-repo` | Yes | | Your catalog repository, in `owner/repo` format. |
+| `catalog-ref` | No | `main` | The catalog branch to read. |
+| `catalog-token` | No | `github.token` | A token that can read the catalog repository. |
+| `catalog-url` | No | | The URL of your hosted catalog. The comment links ADRs to it. Without it, they link to your catalog repository. |
+| `model` | No | `anthropic/claude-sonnet-4-6` | The model the agent uses. See [models](#models). |
+| `ignore-paths` | No | Build and dependency folders | Comma-separated paths or glob patterns to leave out of the review. |
+
+## Models
+
+Use any model from [these providers](https://pi.dev/models). Set `model` to a provider and model name, and pass your provider's key as an environment variable on the step:
+
+| Provider | Model example | Environment variable |
+| --- | --- | --- |
+| Anthropic | `anthropic/claude-sonnet-4-6` | `ANTHROPIC_API_KEY` |
+| OpenAI | `openai/gpt-5.1` | `OPENAI_API_KEY` |
+| OpenRouter | `openrouter/anthropic/claude-sonnet-4.6` | `OPENROUTER_API_KEY` |
+
+To use models in your own AWS account, use an `amazon-bedrock/` model, such as `amazon-bedrock/eu.anthropic.claude-sonnet-4-6`, and give the job AWS credentials with [`aws-actions/configure-aws-credentials`](https://github.com/aws-actions/configure-aws-credentials).
+
+## Data and privacy
+
+- **It's read-only.** It only comments on pull requests, and never edits your catalog.
+- **Your code goes to one place:** the model provider you configure. The agent runs in your GitHub Actions runner. EventCatalog never receives your code, your catalog or your pull requests.
+
+Each run sends one anonymous usage event: the outcome and the kind of error if it failed, the model, the run's duration, whether the pull request was open or merged, and the repository name. It never contains code, file names, paths, diffs or pull request content. To turn it off, set `POSTHOG_KEY: ''` in the step's `env`.
+
+## Versions
+
+ADR Compliance needs `event-catalog/agents@v2.2.0` or later. Use `event-catalog/agents@v2` for the latest v2 release, or an exact release such as `event-catalog/agents@v2.2.0`, which never changes. Releases are listed on [GitHub](https://github.com/event-catalog/agents/tags).

package/dist/docs/development/guides/resources/adrs/01-introduction.md

@@ -20,6 +20,7 @@ Documenting ADRs in your catalog gives your team:
 - **Context** — anyone can see what alternatives were considered and why a particular path was chosen.
 - **Traceability** — decisions are linked directly to the services, events, domains, and flows they affect via `appliesTo`.
 - **Lifecycle tracking** — each ADR has a status (`proposed`, `accepted`, `rejected`, `deprecated`, `superseded`) so it is clear which decisions are still in force.
+- **Checks in pull requests** — the [ADR Compliance workflow](/docs/development/agents/set-up-adr-compliance) comments when a pull request's code conflicts with an accepted decision.
 - **AI-ready context** — because ADRs sit alongside the resources they govern, the [EventCatalog MCP server](/docs/development/ask-your-architecture/mcp-server/introduction) can surface the *why* behind your architecture to AI assistants, not just the *what*. When an LLM is reasoning about a service or event, it picks up the decisions, trade-offs, and constraints recorded in your ADRs.
 
 ## Lifecycle statuses

package/dist/eventcatalog.cjs

@@ -33,11 +33,12 @@ var import_node_path22 = require("path");
 var import_node_http = __toESM(require("http"), 1);
 var import_fs = __toESM(require("fs"), 1);
 var import_node_path23 = __toESM(require("path"), 1);
-var import_node_url2 = require("url");
+var import_node_url3 = require("url");
 var import_node_module3 = require("module");
 
 // src/generate.js
 var import_node_path3 = __toESM(require("path"), 1);
+var import_node_url2 = require("url");
 
 // src/eventcatalog-config-file-utils.js
 var import_promises2 = require("fs/promises");
@@ -174,7 +175,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;
@@ -273,7 +274,7 @@ var generate = async (PROJECT_DIRECTORY) => {
         plugin = plugin.replace("<rootDir>", PROJECT_DIRECTORY);
       }
       try {
-        const importedGenerator = await import(plugin);
+        const importedGenerator = await (import_node_path3.default.isAbsolute(plugin) ? import((0, import_node_url2.pathToFileURL)(plugin).href) : import(plugin));
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {
@@ -3090,7 +3091,7 @@ Run npm i @eventcatalog/core to update`;
 };
 
 // src/eventcatalog.ts
-var currentDir = import_node_path23.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+var currentDir = import_node_path23.default.dirname((0, import_node_url3.fileURLToPath)(importMetaUrl));
 var astroCli = import_node_path23.default.join(import_node_path23.default.dirname((0, import_node_module3.createRequire)(importMetaUrl).resolve("astro/package.json")), "bin/astro.mjs");
 var ASTRO_IN_FOREGROUND = { ASTRO_DEV_BACKGROUND: "1", ASTRO_PREVIEW_BACKGROUND: "1" };
 var program = new import_commander.Command().version(VERSION);
@@ -3576,7 +3577,7 @@ var startServerCatalog = async () => {
   const base = (config?.base || "/").replace(/\/$/, "");
   await runCommandWithFilteredOutput({
     command: process.execPath,
-    args: ["--input-type=module", "-e", SERVER_BOOTSTRAP, (0, import_node_url2.pathToFileURL)(serverEntryPath).href],
+    args: ["--input-type=module", "-e", SERVER_BOOTSTRAP, (0, import_node_url3.pathToFileURL)(serverEntryPath).href],
     cwd: dir,
     env: {
       PROJECT_DIR: dir,

package/dist/eventcatalog.js

@@ -1,18 +1,18 @@
-import {
-  stopChildWithParent
-} from "./chunk-S5GWAUG5.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
+import {
+  stopChildWithParent
+} from "./chunk-S5GWAUG5.js";
 import {
   log_build_default
-} from "./chunk-WN6ZFSXF.js";
+} from "./chunk-3PWCUWQC.js";
 import {
   getLicenseStatus,
   printLicenseStatus
 } from "./chunk-AD7CL772.js";
-import "./chunk-26C26LFE.js";
+import "./chunk-YBM7MCOY.js";
 import "./chunk-YRZK7HKX.js";
 import "./chunk-CA6WCQ2T.js";
 import "./chunk-CPW6G62V.js";
@@ -39,10 +39,10 @@ import {
 } from "./chunk-NKNOXQ62.js";
 import {
   generate
-} from "./chunk-UIJUSHOT.js";
+} from "./chunk-A3256YCN.js";
 import {
   logger
-} from "./chunk-SZU7I2PD.js";
+} from "./chunk-JDSFD7IC.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-PD7KTSYN.js";
@@ -79,7 +79,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-C4L6B5KR.js";
+} from "./chunk-KGFAIGOT.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

@@ -34,6 +34,7 @@ __export(generate_exports, {
 });
 module.exports = __toCommonJS(generate_exports);
 var import_node_path3 = __toESM(require("path"), 1);
+var import_node_url2 = require("url");
 
 // src/eventcatalog-config-file-utils.js
 var import_promises2 = require("fs/promises");
@@ -105,7 +106,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;
@@ -204,7 +205,7 @@ var generate = async (PROJECT_DIRECTORY) => {
         plugin = plugin.replace("<rootDir>", PROJECT_DIRECTORY);
       }
       try {
-        const importedGenerator = await import(plugin);
+        const importedGenerator = await (import_node_path3.default.isAbsolute(plugin) ? import((0, import_node_url2.pathToFileURL)(plugin).href) : import(plugin));
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-UIJUSHOT.js";
-import "./chunk-SZU7I2PD.js";
-import "./chunk-C4L6B5KR.js";
+} from "./chunk-A3256YCN.js";
+import "./chunk-JDSFD7IC.js";
+import "./chunk-KGFAIGOT.js";
 import "./chunk-4G7FSRPN.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.9.0";
+var version = "5.9.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-SZU7I2PD.js";
-import "../chunk-C4L6B5KR.js";
+} from "../chunk-JDSFD7IC.js";
+import "../chunk-KGFAIGOT.js";
 export {
   logger
 };

package/eventcatalog/auth.config.ts

@@ -1,20 +1,18 @@
 import { defineConfig } from '@utils/auth-astro/config';
-import { join } from 'node:path';
 import GitHub from '@auth/core/providers/github';
 import Okta from '@auth/core/providers/okta';
 import type { Account, Profile, User, Session } from '@auth/core/types';
 import { isAuthEnabled, isSSR } from '@utils/feature';
+import { importCatalogModule } from '@utils/catalog-modules';
 import Google from '@auth/core/providers/google';
 import Auth0 from '@auth/core/providers/auth0';
 import Entra from '@auth/core/providers/microsoft-entra-id';
 import jwt from 'jsonwebtoken';
 
 // Need to try and read the eventcatalog.auth.js file and get the auth providers from there
-const catalogDirectory = process.env.PROJECT_DIR || process.cwd();
-
 const getAuthProviders = async () => {
   try {
-    const config = await import(/* @vite-ignore */ join(catalogDirectory, 'eventcatalog.auth.js'));
+    const config = await importCatalogModule('eventcatalog.auth.js');
     const authConfig = config.default;
 
     const providers = [];
@@ -98,6 +96,7 @@ const getAuthProviders = async () => {
 
     return providers;
   } catch (error) {
+    console.error('❌ Failed to load the auth providers from eventcatalog.auth.js:', error);
     return [];
   }
 };
@@ -110,13 +109,13 @@ const getAuthConfig = async () => {
     };
   }
   try {
-    const config = await import(/* @vite-ignore */ join(catalogDirectory, 'eventcatalog.auth.js'));
+    const config = await importCatalogModule('eventcatalog.auth.js');
     const authConfig = config.default;
 
     // If custom auth config is specified (Enterprise feature)
     if (authConfig?.customAuthConfig) {
       try {
-        const customConfig = await import(/* @vite-ignore */ join(catalogDirectory, authConfig.customAuthConfig));
+        const customConfig = await importCatalogModule(authConfig.customAuthConfig);
         return customConfig.default;
       } catch (error) {
         console.error('❌ Failed to load custom auth config:', error);
@@ -212,9 +211,8 @@ const getAuthConfig = async () => {
       debug: authConfig?.debug || false,
     };
   } catch (error) {
-    console.log(
-      'No auth config found, auth disabled. If you want to use auth, create a eventcatalog.auth.js file in your project directory.'
-    );
+    // Auth is enabled and eventcatalog.auth.js exists (isAuthEnabled checks both), so the file failed to load
+    console.error('❌ Failed to load eventcatalog.auth.js, auth disabled:', error);
     return {
       providers: [],
       pages: {

package/eventcatalog/src/features/ai/chat-api.ts

@@ -9,7 +9,7 @@ import {
   type LanguageModel,
   type UIMessage,
 } from 'ai';
-import { join } from 'node:path';
+import { importCatalogModule } from '@utils/catalog-modules';
 import { isCanvasEnabled, isDevMode } from '@utils/feature';
 import { getCollection, getEntry } from 'astro:content';
 import { z } from 'astro/zod';
@@ -33,8 +33,6 @@ import {
   toolDescriptions,
 } from '@features/tools/catalog-tools';
 
-const catalogDirectory = process.env.PROJECT_DIR || process.cwd();
-
 // How many model calls one answer may take. Questions across several domains need many tool calls, so the last
 // step has tools turned off: the model has to answer with what it found, rather than stop without a reply.
 const MAX_STEPS = 10;
@@ -58,7 +56,7 @@ let modelConfiguration: any;
 let extendedTools: any;
 
 try {
-  const providerConfiguration = await import(/* @vite-ignore */ join(catalogDirectory, 'eventcatalog.chat.js'));
+  const providerConfiguration = await importCatalogModule('eventcatalog.chat.js');
   model = await providerConfiguration.default();
   modelConfiguration = providerConfiguration.configuration || defaultConfiguration;
   hasChatConfiguration = true;

package/eventcatalog/src/features/auth/login.astro

@@ -3,18 +3,16 @@ import '../../styles/tailwind.css';
 import config from '@config';
 import { formatPageTitle } from '@utils/page-title';
 const { title, logo } = config;
-import { join } from 'node:path';
 import { isAuthEnabled, isSSR } from '@utils/feature';
 import { buildUrl } from '@utils/url-builder';
 import { getSession } from '@utils/auth-astro/server';
-
-const catalogDirectory = process.env.PROJECT_DIR || process.cwd();
+import { importCatalogModule } from '@utils/catalog-modules';
 
 let hasAuthConfigurationFile = false;
 let providers: string[] = [];
 
 try {
-  const authConfig = await import(/* @vite-ignore */ join(catalogDirectory, 'eventcatalog.auth.js'));
+  const authConfig = await importCatalogModule('eventcatalog.auth.js');
   providers = Object.keys(authConfig.default.providers);
   hasAuthConfigurationFile = true;
 } catch (error) {

package/eventcatalog/src/features/auth/middleware/middleware.ts

@@ -1,15 +1,14 @@
 import type { MiddlewareHandler } from 'astro';
 import { authMiddleware } from './middleware-auth.ts';
 import { sequence } from 'astro:middleware';
-import { join } from 'node:path';
+import { importCatalogModule } from '@utils/catalog-modules';
 import { isSSR } from '@utils/feature';
 
 // Try to load customer's custom RBAC middleware
 let customerRbacMiddleware: MiddlewareHandler | null = null;
 
 try {
-  const catalogDirectory = process.env.PROJECT_DIR || process.cwd();
-  const customerMiddleware = await import(/* @vite-ignore */ join(catalogDirectory, 'middleware.ts'));
+  const customerMiddleware = await importCatalogModule('middleware.ts');
   customerRbacMiddleware = customerMiddleware.rbacMiddleware;
 
   if (!isSSR()) {

package/eventcatalog/src/features/mcp/mcp-server.ts

@@ -3,6 +3,7 @@ import { Hono, type Context } from 'hono';
 import { McpServer, WebStandardStreamableHTTPServerTransport, type StandardSchemaWithJSON } from '@modelcontextprotocol/server';
 import { z } from 'zod';
 import { join } from 'node:path';
+import { importCatalogModule } from '@utils/catalog-modules';
 import * as catalogTools from '@features/tools/catalog-tools';
 import { getCollection } from 'astro:content';
 import { createMcpAuthErrorResponse, validateMcpRequest } from './mcp-auth';
@@ -78,7 +79,7 @@ function createToolHandler<T>(fn: (params: T) => Promise<any>, errorMessage: str
 let extendedTools: Record<string, any> = {};
 
 try {
-  const providerConfiguration = await import(/* @vite-ignore */ join(catalogDirectory, 'eventcatalog.chat.js'));
+  const providerConfiguration = await importCatalogModule('eventcatalog.chat.js');
 
   if (providerConfiguration.tools) {
     extendedTools = providerConfiguration.tools;

package/eventcatalog/src/utils/catalog-modules.ts

@@ -0,0 +1,16 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+/**
+ * The file:// URL of a file in the catalog. Node's ES module loader only takes URLs: on Windows an absolute path
+ * (C:\catalog\eventcatalog.auth.js) reads as a URL with the scheme "c:", and the import fails.
+ */
+export const catalogModuleUrl = (file: string, directory = process.env.PROJECT_DIR || process.cwd()) =>
+  pathToFileURL(join(directory, file)).href;
+
+/**
+ * Imports a module from the catalog (eventcatalog.auth.js, eventcatalog.chat.js, middleware.ts), at runtime rather
+ * than bundled into the build, so the catalog's own file is the one that runs.
+ */
+export const importCatalogModule = (file: string, directory?: string) =>
+  import(/* @vite-ignore */ catalogModuleUrl(file, directory));

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "BUSL-1.1",
   "type": "module",
-  "version": "5.9.0",
+  "version": "5.9.1",
   "publishConfig": {
     "access": "public"
   },
@@ -142,9 +142,9 @@
     "yjs": "^13.6.33",
     "zod": "^4.6.6",
     "@eventcatalog/exporters": "0.1.4",
+    "@eventcatalog/fitness": "0.1.1",
     "@eventcatalog/sdk": "2.32.0",
     "@eventcatalog/visualiser": "^5.2.5",
-    "@eventcatalog/fitness": "0.1.1",
     "@eventcatalog/linter": "1.3.1"
   },
   "devDependencies": {