From 44ee9e6ab537a5f015bf7c97a7ac0db63b492797 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 5 Apr 2026 07:52:48 +0000 Subject: [PATCH 1/2] Add AGENTS.md with Cursor Cloud development instructions Co-authored-by: Daxiong (Lin) --- AGENTS.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..883944507 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,31 @@ +# AGENTS.md + +## Cursor Cloud specific instructions + +This is the **ComfyUI Official Documentation** site, built with [Mintlify](https://mintlify.com/). There is no backend, database, or build step — only a static docs preview server. + +### Running the dev server + +``` +npm run dev +``` + +This runs `npx mint dev` and starts the Mintlify local preview server on **port 3000**. The initial startup takes ~90 seconds due to ~3000 MDX files being processed. Hot-reload works for content edits. + +### Lint / CI checks available locally + +- **Broken links**: `npx mint broken-links` — checks for broken internal links across all pages. +- **OpenAPI check**: `npx mint openapi-check https://api.comfy.org/openapi` — validates OpenAPI schema references. +- There is no ESLint, TypeScript, or other code linting — this is a pure documentation repo. + +### Key files + +- `docs.json` — Main configuration for navigation, theming, redirects, and localization. +- `package.json` — Only two runtime deps: `mint` and `sharp`. +- `.github/workflows/` — CI checks for broken links, redirects, translation sync, and link validation. + +### Gotchas + +- The dev server may show navigation warnings about Japanese (`ja/`) translation pages that are referenced in `docs.json` but don't exist yet. These are non-blocking warnings. +- When renaming or moving `.mdx` files, redirects must be added to `docs.json` — a CI check enforces this on PRs. +- Chinese (`zh/`) translation files must be updated when modifying English `.mdx` files — enforced by CI. From a6d061a2d628a392f12d10cd375b8d42c54e6884 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 5 Apr 2026 07:54:37 +0000 Subject: [PATCH 2/2] Update package-lock.json from npm install Co-authored-by: Daxiong (Lin) --- package-lock.json | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/package-lock.json b/package-lock.json index d60d0f660..2dd625dc4 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,5 +1,5 @@ { - "name": "sno-japanese", + "name": "workspace", "lockfileVersion": 3, "requires": true, "packages": { @@ -295,6 +295,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6541,6 +6542,7 @@ "cpu": [ "ppc64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6557,6 +6559,7 @@ "cpu": [ "arm" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6573,6 +6576,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6589,6 +6593,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6605,6 +6610,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6621,6 +6627,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6637,6 +6644,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6653,6 +6661,7 @@ "cpu": [ "arm" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6669,6 +6678,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6685,6 +6695,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6701,6 +6712,7 @@ "cpu": [ "loong64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6717,6 +6729,7 @@ "cpu": [ "mips64el" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6733,6 +6746,7 @@ "cpu": [ "ppc64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6749,6 +6763,7 @@ "cpu": [ "riscv64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6765,6 +6780,7 @@ "cpu": [ "s390x" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6781,6 +6797,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6797,6 +6814,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6813,6 +6831,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6829,6 +6848,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6845,6 +6865,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6861,6 +6882,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6877,6 +6899,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6893,6 +6916,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -6909,6 +6933,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [