diff --git a/.github/workflows/ci-code-quality.yaml b/.github/workflows/ci-code-quality.yaml
new file mode 100644
index 00000000000..ac1516d22e0
--- /dev/null
+++ b/.github/workflows/ci-code-quality.yaml
@@ -0,0 +1,41 @@
+name: 'CI: Code Quality Package'
+
+on:
+ pull_request:
+ paths:
+ - 'packages/code-quality/**'
+ - 'pnpm-lock.yaml'
+ - '.github/workflows/ci-code-quality.yaml'
+ push:
+ branches: [main]
+ paths:
+ - 'packages/code-quality/**'
+ - 'pnpm-lock.yaml'
+ - '.github/workflows/ci-code-quality.yaml'
+
+permissions:
+ contents: read
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ package:
+ runs-on: ubuntu-latest
+ timeout-minutes: 15
+ strategy:
+ fail-fast: false
+ matrix:
+ manager: [npm, pnpm]
+ steps:
+ - uses: actions/checkout@v7
+ - uses: ./.github/actions/setup-frontend
+ - run: pnpm --filter @comfyorg/code-quality check
+ - run: pnpm --filter @comfyorg/code-quality test:coverage
+ - run: pnpm --filter @comfyorg/code-quality smoke:pack ${{ matrix.manager }}
+ - uses: actions/upload-artifact@v6
+ if: always()
+ with:
+ name: code-quality-coverage-${{ matrix.manager }}
+ path: packages/code-quality/coverage
diff --git a/.husky/pre-commit b/.husky/pre-commit
index 1451759bf5a..ff91c3e917f 100755
--- a/.husky/pre-commit
+++ b/.husky/pre-commit
@@ -3,4 +3,7 @@ set -e
pnpm exec lint-staged
pnpm exec tsx scripts/check-unused-i18n-keys.ts
-pnpm exec tsx scripts/check-frozen-dirs.ts
\ No newline at end of file
+pnpm exec tsx scripts/check-frozen-dirs.ts
+if git diff --cached --name-only | grep -q '^packages/code-quality/'; then
+ pnpm --filter @comfyorg/code-quality check
+fi
diff --git a/.husky/pre-push b/.husky/pre-push
index eca5e3a9cff..311334c3c48 100755
--- a/.husky/pre-push
+++ b/.husky/pre-push
@@ -17,3 +17,9 @@ diff_file="$(mktemp)"
trap 'rm -f "$diff_file"' 0
git diff --unified=0 --relative "$base"...HEAD -- > "$diff_file"
pnpm fallow:audit --changed-since "$base" --diff-file "$diff_file" 1>&2
+
+if git diff --name-only "$base" HEAD | grep -q '^packages/code-quality/'; then
+ pnpm --filter @comfyorg/code-quality check
+ pnpm --filter @comfyorg/code-quality smoke:pack npm
+ pnpm --filter @comfyorg/code-quality smoke:pack pnpm
+fi
diff --git a/docs/adr/DEVEX-QUALITY-0040-shared-code-quality-package.md b/docs/adr/DEVEX-QUALITY-0040-shared-code-quality-package.md
new file mode 100644
index 00000000000..0cdd0c30f35
--- /dev/null
+++ b/docs/adr/DEVEX-QUALITY-0040-shared-code-quality-package.md
@@ -0,0 +1,43 @@
+# ADR-DEVEX-QUALITY-0040: Share a versioned code-quality package
+
+Date: 2026-10-02
+
+## Status
+
+Proposed
+
+## Context
+
+Platform stays in its own repository. Copying Frontend lint, formatting and audit
+policy leaves consumers maintaining engine compatibility and policy drift.
+Separate configuration packages alone do not give Platform a single tested update.
+
+## Decision
+
+Publish `@comfyorg/code-quality` from Frontend. Pin compatible engines and common
+plugins, export reusable policies, and provide thin lint/format/audit commands.
+Keep native tool configuration and caching; add no task graph or build orchestration.
+
+Frontend retains Oxfmt; Platform retains Prettier and Nuxt's generated ESLint
+adapter. Repositories own paths, framework configuration, application restrictions,
+ignore files, baselines, typechecks, builds and tests. ESLint-only use is supported;
+overlapping rules may only be disabled where the same files run through Oxlint.
+
+Validate the tarball in clean npm and pnpm consumers before release. Reuse the
+existing version-bump PR and publication workflow. Changes that introduce failures
+in passing consumers are breaking changes. Consumers pin one package version and
+commit its lockfile; rollback reverts both.
+
+## Consequences
+
+### Positive
+
+- Tool compatibility and common policy have one owner and a tested release unit.
+- Platform can update shared guardrails without copying Frontend configuration.
+
+### Negative
+
+- The package installs both formatter and linter engines even when one is unused.
+- Framework adapters and local scopes still need consumer tests.
+- Publishing and adoption remain ordered steps; a passing local tarball does not
+ establish a successful registry release.
diff --git a/docs/adr/README.md b/docs/adr/README.md
index e31a94051c0..039001ca4b3 100644
--- a/docs/adr/README.md
+++ b/docs/adr/README.md
@@ -48,6 +48,7 @@ An Architecture Decision Record captures an important architectural decision mad
| [DEVEX-BUILD-0010](DEVEX-BUILD-0010-remove-nx-orchestration.md) | Remove Nx Orchestration | Accepted | 2026-05-19 |
| [DEVEX-LINT-0015](DEVEX-LINT-0015-adopt-fallow-with-new-only-baselines.md) | Adopt Fallow with New-Only Baselines | Proposed | 2026-06-29 |
| [DEVEX-MONOREPO-0002](DEVEX-MONOREPO-0002-adopt-a-pnpm-workspace-monorepo.md) | Adopt a pnpm Workspace Monorepo | Accepted | 2025-08-25 |
+| [DEVEX-QUALITY-0040](DEVEX-QUALITY-0040-shared-code-quality-package.md) | Share a versioned code-quality package | Proposed | 2026-10-02 |
| [ECS-0008](ECS-0008-entity-component-system.md) | Entity Component System | Proposed | 2026-03-23 |
| [ECS-IDENTITY-0016](ECS-IDENTITY-0016-entity-id-collision-policy-and-recovery.md) | Entity ID Collision Policy and Recovery | Proposed | 2026-08-24 |
| [ECS-LINK-PRESENTATION-0028](ECS-LINK-PRESENTATION-0028-link-presentation-store-ownership.md) | Link Presentation Store Owns Hidden/Label State | Proposed | 2026-08-29 |
diff --git a/knip.config.ts b/knip.config.ts
index 3bd1ca34bd5..856c320cb66 100644
--- a/knip.config.ts
+++ b/knip.config.ts
@@ -24,6 +24,11 @@ const config: KnipConfig = {
],
ignore: ['scripts/registry-census/detection-proof/**']
},
+ 'packages/code-quality': {
+ entry: ['src/{cli,eslint,format,plugin}.ts'],
+ project: ['src/**/*.ts', 'scripts/**/*.ts', 'tests/**/*.ts'],
+ ignoreDependencies: ['fallow', 'prettier']
+ },
'packages/account-core': {
project: ['src/**/*.{js,ts}']
},
diff --git a/packages/code-quality/LICENSE b/packages/code-quality/LICENSE
new file mode 100644
index 00000000000..f288702d2fa
--- /dev/null
+++ b/packages/code-quality/LICENSE
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+
+ Copyright (C)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see .
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ Copyright (C)
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+.
diff --git a/packages/code-quality/README.md b/packages/code-quality/README.md
new file mode 100644
index 00000000000..41fc18020c2
--- /dev/null
+++ b/packages/code-quality/README.md
@@ -0,0 +1,107 @@
+# @comfyorg/code-quality
+
+
+
+One version for Comfy's code-quality engines and reusable policy. Install as a
+**dev dependency** with npm or pnpm; Node 22.13+ (22.x) or 24+ is required.
+
+```sh
+npm install --save-dev --save-exact @comfyorg/code-quality@next
+npx comfy-code-quality lint
+npx comfy-code-quality format --check
+npx comfy-code-quality audit --base origin/main --json > fallow-results.json
+```
+
+The package pins ESLint, Oxlint, the matching overlap adapter, TypeScript/parser,
+Vue/import/test plugins, Oxfmt, Prettier, and Fallow. Prettier stays on Platform's existing 3.5.3 to avoid an unrelated formatting migration. It does not run app builds,
+typechecks, or tests. Framework-specific ESLint plugins remain local.
+
+## Consumer configuration
+
+Create `code-quality.config.json` with native arguments and local scopes:
+
+```json
+{
+ "lint": {
+ "oxlint": ["src", "--type-aware"],
+ "eslint": ["src", "--cache"]
+ },
+ "format": { "engine": "oxfmt", "args": ["src", "scripts"] },
+ "audit": ["--quiet"]
+}
+```
+
+Omit `lint.oxlint` to use ESLint alone. Keep all ESLint rules enabled in that mode.
+In hybrid mode, apply the exported `oxlint` overlap adapter only to the files
+actually checked by Oxlint. In particular, Astro and Vue template policy must
+remain covered by ESLint. The wrapper does not silently disable any rules.
+
+`lint` runs Oxlint first and stops on failure, then runs ESLint. `--fix` applies
+to both. Additional lint/format paths append to configured arguments; they do
+not narrow an existing scope. `format` writes; `format --check` only checks.
+`audit --base` compares tracked working-tree changes against an explicit commit,
+uses a zero-context diff to filter added lines, and removes its temporary diff.
+Commit or stage new files before auditing. It never refreshes baselines.
+
+`-c/--config` selects the wrapper JSON file. `-h/--help` and `-V/--version` work
+without a config. `-b` aliases audit's `--base`. Native tool output passes through,
+including JSON audit output on stdout. Native failure statuses pass through;
+usage/config/spawn errors go to stderr with exit 2. No package-specific environment
+variables are required; engines retain their documented environment behavior.
+
+For existing scripts and baseline administration, `comfy-code-quality exec
+[args...]` runs the pinned `eslint`, `oxlint`, `oxfmt`, `prettier`, or `fallow`
+with native arguments and no wrapper config. For example,
+`comfy-code-quality exec fallow dead-code --save-baseline .fallow-baselines/dead-code.json`.
+This explicit native command can write a baseline; `audit` never does.
+
+## Presets and adapters
+
+- `@comfyorg/code-quality/eslint`: rule-only `imports(namespace)`, `vueTemplates`,
+ `asyncSafety`, `browserTests`, and `unitTests`; plus pinned plugins/parsers.
+ Spread a policy into a locally scoped flat-config object. `imports('import')`
+ composes with Nuxt's existing import plugin; the default is `import-x`.
+ Typed async rules need the consumer's TypeScript project/parser options.
+- `@comfyorg/code-quality/plugin`: portable `no-js-private-class-members` rule.
+- `@comfyorg/code-quality/oxlint.json`: native type-import policy. Extend it from
+ local `.oxlintrc.json`; keep local suppressions and application restrictions.
+- Fallow: set `"extends": "npm:@comfyorg/code-quality/dist/presets/fallow.json"` in
+ `.fallowrc.json`. The preset sets new-only gating, three-copy duplication, and
+ production dev-dependency checks. Entry points, overrides and baselines stay local.
+- `@comfyorg/code-quality/format`: named `frontend` (Oxfmt) and `platform`
+ (Prettier) profiles. For example, in `prettier.config.mjs`:
+ `export { platform as default } from '@comfyorg/code-quality/format'`.
+ Oxfmt also supports an `.oxfmtrc.mjs` exporting `frontend`; spread it to add
+ local `ignorePatterns`. Ignore files stay in the consumer.
+
+Nuxt consumers keep `withNuxt` and its generated configuration. Import shared
+rule objects into that composition; do not register another copy of plugins
+already supplied by Nuxt. ESLint editor integrations may still require a direct
+ESLint dependency aligned with this package; the command always uses our engine.
+
+## Verification and releases
+
+```sh
+pnpm -C packages/code-quality check
+pnpm -C packages/code-quality test:coverage
+pnpm -C packages/code-quality smoke:pack npm
+pnpm -C packages/code-quality smoke:pack pnpm
+open packages/code-quality/coverage/index.html
+```
+
+Unit tests cover config/usage failures. Packed-consumer tests run the installed
+binary through PATH, valid/invalid Vue and TypeScript, async/test guardrails,
+hybrid mode, formatter check/write/idempotence, and Fallow new/inherited findings.
+Help has a five-second startup budget. Coverage reports include text, HTML and
+LCOV; subprocess engine behavior is verified by smoke tests, not coverage totals.
+
+Release through the existing version-bump/Release-PR workflow after CI support
+lands. Alpha versions go to `next`. Rule or engine changes that reject previously
+passing code require an explicitly documented breaking release, including during
+alpha. Consumers commit exact manifest and lockfile updates together; roll back
+by reverting that update and reinstalling the lockfile. A successful tarball test
+is not proof of registry publication or Platform adoption.
+
+Last measured: 2026-10-02 23:35 PDT. Fourteen tests pass; in-process coverage is
+44.26% lines. Subprocess CLI paths and the native engines are exercised by the
+installed-command smoke tests and are not included in that coverage total.
diff --git a/packages/code-quality/package.json b/packages/code-quality/package.json
new file mode 100644
index 00000000000..23653d0c7dc
--- /dev/null
+++ b/packages/code-quality/package.json
@@ -0,0 +1,67 @@
+{
+ "name": "@comfyorg/code-quality",
+ "version": "0.1.0-alpha.0",
+ "description": "Pinned Comfy code-quality tools and reusable policy",
+ "license": "GPL-3.0-only",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/Comfy-Org/ComfyUI_frontend.git",
+ "directory": "packages/code-quality"
+ },
+ "bin": {
+ "comfy-code-quality": "./dist/cli.js"
+ },
+ "files": [
+ "dist"
+ ],
+ "type": "module",
+ "exports": {
+ "./eslint": "./dist/eslint.js",
+ "./format": "./dist/format.js",
+ "./oxlint.json": "./dist/presets/oxlint.json",
+ "./fallow.json": "./dist/presets/fallow.json",
+ "./package.json": "./package.json",
+ "./plugin": "./dist/plugin.js"
+ },
+ "publishConfig": {
+ "access": "public"
+ },
+ "scripts": {
+ "build": "tsc -p tsconfig.build.json && tsx scripts/build.ts",
+ "prepack": "pnpm run build",
+ "typecheck": "tsc --noEmit",
+ "test": "vitest run",
+ "test:coverage": "vitest run --coverage",
+ "format": "oxfmt --write",
+ "format:check": "oxfmt --check",
+ "lint": "oxlint --deny-warnings src tests",
+ "check": "pnpm build && pnpm typecheck && pnpm lint && pnpm format:check && pnpm test",
+ "smoke:pack": "tsx scripts/smokePack.ts"
+ },
+ "dependencies": {
+ "@vitest/eslint-plugin": "1.6.27",
+ "eslint": "10.10.0",
+ "eslint-config-prettier": "10.1.8",
+ "eslint-plugin-import-x": "4.17.1",
+ "eslint-plugin-oxlint": "1.77.0",
+ "eslint-plugin-playwright": "2.11.0",
+ "eslint-plugin-vue": "10.10.0",
+ "fallow": "3.24.1",
+ "oxfmt": "0.59.0",
+ "oxlint": "1.77.0",
+ "oxlint-tsgolint": "7.0.2001",
+ "prettier": "3.5.3",
+ "typescript": "6.0.3",
+ "typescript-eslint": "8.69.0",
+ "vue-eslint-parser": "10.4.1"
+ },
+ "devDependencies": {
+ "@types/node": "catalog:",
+ "@vitest/coverage-v8": "catalog:",
+ "tsx": "catalog:",
+ "vitest": "catalog:"
+ },
+ "engines": {
+ "node": "^22.13.0 || >=24.0.0"
+ }
+}
diff --git a/packages/code-quality/presets/fallow.json b/packages/code-quality/presets/fallow.json
new file mode 100644
index 00000000000..9b582d4346f
--- /dev/null
+++ b/packages/code-quality/presets/fallow.json
@@ -0,0 +1,12 @@
+{
+ "$schema": "https://raw.githubusercontent.com/fallow-rs/fallow/v3.24.1/schema.json",
+ "duplicates": {
+ "minOccurrences": 3
+ },
+ "audit": {
+ "gate": "new-only"
+ },
+ "rules": {
+ "dev-dependencies-in-production": "error"
+ }
+}
diff --git a/packages/code-quality/presets/oxlint.json b/packages/code-quality/presets/oxlint.json
new file mode 100644
index 00000000000..8d759b6c394
--- /dev/null
+++ b/packages/code-quality/presets/oxlint.json
@@ -0,0 +1,7 @@
+{
+ "plugins": ["typescript", "import"],
+ "rules": {
+ "typescript/consistent-type-imports": "error",
+ "import/consistent-type-specifier-style": ["error", "prefer-top-level"]
+ }
+}
diff --git a/packages/code-quality/scripts/build.ts b/packages/code-quality/scripts/build.ts
new file mode 100644
index 00000000000..dd3e561f648
--- /dev/null
+++ b/packages/code-quality/scripts/build.ts
@@ -0,0 +1,7 @@
+import { cp } from 'node:fs/promises'
+
+await cp(
+ new URL('../presets/', import.meta.url),
+ new URL('../dist/presets/', import.meta.url),
+ { recursive: true }
+)
diff --git a/packages/code-quality/scripts/smokePack.ts b/packages/code-quality/scripts/smokePack.ts
new file mode 100644
index 00000000000..fb205044f95
--- /dev/null
+++ b/packages/code-quality/scripts/smokePack.ts
@@ -0,0 +1,290 @@
+import assert from 'node:assert/strict'
+import { spawnSync } from 'node:child_process'
+import { mkdtemp, readFile, readdir, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { delimiter, join, resolve } from 'node:path'
+import { performance } from 'node:perf_hooks'
+
+const packageRoot = resolve(import.meta.dirname, '..')
+const env = Object.fromEntries(
+ Object.entries(process.env).filter(([name]) => !name.startsWith('GIT_'))
+)
+const directory = await mkdtemp(join(tmpdir(), 'code-quality-consumer-'))
+
+function run(command: string, args: string[], cwd = directory, expected = 0) {
+ const result = spawnSync(command, args, {
+ cwd,
+ encoding: 'utf8',
+ env: {
+ ...env,
+ PATH: `${join(cwd, 'node_modules', '.bin')}${delimiter}${process.env.PATH}`
+ },
+ maxBuffer: 16 * 1024 * 1024
+ })
+ if (result.error) throw result.error
+ assert.equal(
+ result.status,
+ expected,
+ `${command} ${args.join(' ')}\n${result.stdout}\n${result.stderr}`
+ )
+ return result.stdout + result.stderr
+}
+
+async function write(name: string, content: string) {
+ await writeFile(join(directory, name), content)
+}
+
+try {
+ run('pnpm', ['pack', '--pack-destination', directory], packageRoot)
+ const tarball = (await readdir(directory)).find((name) =>
+ name.endsWith('.tgz')
+ )
+ assert.ok(tarball)
+ await write('package.json', JSON.stringify({ private: true, type: 'module' }))
+ const manager = process.argv[2] ?? 'npm'
+ assert.ok(manager === 'npm' || manager === 'pnpm', 'Use npm or pnpm')
+ if (manager === 'pnpm')
+ await write('pnpm-workspace.yaml', 'allowBuilds:\n unrs-resolver: false\n')
+ run(
+ manager,
+ manager === 'npm'
+ ? ['install', '--no-audit', '--no-fund', join(directory, tarball)]
+ : [
+ 'add',
+ '--config.manage-package-manager-versions=false',
+ join(directory, tarball)
+ ]
+ )
+ assert.match(
+ run('comfy-code-quality', ['exec', 'prettier', '--version']),
+ /3\.5\.3/
+ )
+ assert.match(
+ run('comfy-code-quality', ['exec', 'unknown'], directory, 2),
+ /Unknown tool/
+ )
+ const start = performance.now()
+ assert.match(run('comfy-code-quality', ['--help']), /lint\|format\|audit/)
+ assert.ok(
+ performance.now() - start < 5000,
+ 'Help startup must stay under 5 seconds'
+ )
+ assert.match(run('comfy-code-quality', ['--version']), /\d+\.\d+\.\d+/)
+ assert.match(
+ run('comfy-code-quality', ['unknown'], directory, 2),
+ /Unknown command/
+ )
+ assert.match(
+ run('comfy-code-quality', ['lint', '--unknown'], directory, 2),
+ /Unknown option/
+ )
+ await write(
+ 'tsconfig.json',
+ JSON.stringify({
+ compilerOptions: {
+ target: 'ES2022',
+ module: 'ESNext',
+ moduleResolution: 'Bundler',
+ strict: true,
+ noEmit: true
+ },
+ include: ['*.ts', '*.vue']
+ })
+ )
+ await write(
+ 'eslint.config.mjs',
+ `import { typescript, vue, vueParser, importX, imports, vueTemplates, asyncSafety, playwright, browserTests, vitest, unitTests, prettier } from '@comfyorg/code-quality/eslint'
+export default [
+ ...vue.configs['flat/recommended'],
+ { files: ['**/*.ts', '**/*.vue'], languageOptions: { parser: typescript.parser }, plugins: { '@typescript-eslint': typescript.plugin, 'import-x': importX }, ...imports() },
+ { files: ['**/*.ts'], languageOptions: { parserOptions: { project: './tsconfig.json' } }, ...asyncSafety },
+ { files: ['**/*.vue'], languageOptions: { parser: vueParser, parserOptions: { parser: typescript.parser } }, ...vueTemplates },
+ { files: ['**/*.spec.ts'], plugins: { playwright }, ...browserTests },
+ { files: ['**/*.test.ts'], plugins: { vitest }, ...unitTests },
+ prettier
+]
+`
+ )
+ await write('types.ts', 'export interface Input { name: string }\n')
+ const good =
+ "import type { Input } from './types'\nexport function name(input: Input) { return input.name }\n"
+ const goodVue =
+ '\nReady
{{ item }}\n'
+ await write('main.ts', good)
+ await write('App.vue', goodVue)
+ const quality = {
+ lint: {
+ eslint: ['main.ts', 'App.vue', 'sample.test.ts', 'sample.spec.ts']
+ },
+ format: {
+ engine: 'prettier',
+ args: ['main.ts', '--config', 'prettier.config.mjs']
+ },
+ audit: ['--quiet']
+ }
+ await write('code-quality.config.json', JSON.stringify(quality))
+ await write(
+ 'sample.test.ts',
+ "import { it, expect } from 'vitest'\nit('works', () => { expect(1).toBe(1) })\n"
+ )
+ await write(
+ 'sample.spec.ts',
+ "import { test, expect } from '@playwright/test'\ntest('works', async ({ page }) => { await expect(page.locator('button')).toBeVisible() })\n"
+ )
+ run('comfy-code-quality', ['lint'])
+ for (const [file, bad, rule, restore] of [
+ [
+ 'main.ts',
+ good.replace('import type', 'import'),
+ 'consistent-type-imports',
+ good
+ ],
+ ['main.ts', `${good}\nPromise.resolve(1)\n`, 'no-floating-promises', good],
+ [
+ 'App.vue',
+ goodVue.replace(
+ ' { expect(1).toBe(1) })\n",
+ 'no-focused-tests',
+ await readFile(join(directory, 'sample.test.ts'), 'utf8')
+ ],
+ [
+ 'sample.spec.ts',
+ "import { test, expect } from '@playwright/test'\ntest('works', async ({ page }) => { expect(page.locator('button')).toBeVisible() })\n",
+ 'missing-playwright-await',
+ await readFile(join(directory, 'sample.spec.ts'), 'utf8')
+ ]
+ ]) {
+ await write(file, bad)
+ try {
+ assert.match(
+ run('comfy-code-quality', ['lint'], directory, 1),
+ new RegExp(rule)
+ )
+ } catch (cause) {
+ throw new Error(`Rejection probe failed: ${rule}`, { cause })
+ }
+ await write(file, restore)
+ }
+ await write(
+ 'oxlint.json',
+ JSON.stringify({
+ extends: [
+ './node_modules/@comfyorg/code-quality/dist/presets/oxlint.json'
+ ]
+ })
+ )
+ await write(
+ 'code-quality.config.json',
+ JSON.stringify({
+ ...quality,
+ lint: { ...quality.lint, oxlint: ['main.ts', '-c', 'oxlint.json'] }
+ })
+ )
+ await write('main.ts', good.replace('import type', 'import'))
+ assert.match(
+ run('comfy-code-quality', ['lint'], directory, 1),
+ /consistent-type-imports/
+ )
+ await write('main.ts', good)
+ run('comfy-code-quality', ['lint'])
+ for (const [engine, profile, config] of [
+ ['prettier', 'platform', 'prettier.config.mjs'],
+ ['oxfmt', 'frontend', '.oxfmtrc.mjs']
+ ]) {
+ await write(
+ config,
+ `export { ${profile} as default } from '@comfyorg/code-quality/format'\n`
+ )
+ await write(
+ 'code-quality.config.json',
+ JSON.stringify({
+ ...quality,
+ format: { engine, args: ['main.ts', '--config', config] }
+ })
+ )
+ await write('main.ts', 'export const text="hello"')
+ run('comfy-code-quality', ['format', '--check'], directory, 1)
+ run('comfy-code-quality', ['format'])
+ const formatted = await readFile(join(directory, 'main.ts'), 'utf8')
+ assert.equal(
+ formatted,
+ profile === 'platform'
+ ? 'export const text = "hello";\n'
+ : "export const text = 'hello'\n"
+ )
+ run('comfy-code-quality', ['format', '--check'])
+ run('comfy-code-quality', ['format'])
+ assert.equal(await readFile(join(directory, 'main.ts'), 'utf8'), formatted)
+ }
+ assert.match(
+ run('comfy-code-quality', ['audit'], directory, 2),
+ /requires --base/
+ )
+ assert.match(
+ run('comfy-code-quality', ['audit', '--base', 'nonexistent'], directory, 2),
+ /git|revision|repository|version/
+ )
+ await write('.gitignore', 'node_modules/\n*.tgz\n.fallow/\n')
+ await write(
+ '.fallowrc.json',
+ JSON.stringify({
+ extends: 'npm:@comfyorg/code-quality/dist/presets/fallow.json',
+ entry: ['main.ts'],
+ ignorePatterns: ['App.vue', 'sample.*.ts', 'types.ts']
+ })
+ )
+ await write('main.ts', "import { live } from './lib'\nconsole.log(live)\n")
+ await write('lib.ts', 'export const live = 1\n')
+ run('git', ['init', '-q'])
+ run('git', ['add', '.'])
+ run('git', [
+ '-c',
+ 'user.name=Fixture',
+ '-c',
+ 'user.email=fixture@example.invalid',
+ 'commit',
+ '-qm',
+ 'base'
+ ])
+ const base = run('git', ['rev-parse', 'HEAD']).trim()
+ await write('lib.ts', 'export const live = 2\nexport const unused = 1\n')
+ const failure = run(
+ 'comfy-code-quality',
+ ['audit', '--base', base, '--json'],
+ directory,
+ 1
+ )
+ assert.equal(JSON.parse(failure).verdict, 'fail')
+ run('git', ['add', '.'])
+ run('git', [
+ '-c',
+ 'user.name=Fixture',
+ '-c',
+ 'user.email=fixture@example.invalid',
+ 'commit',
+ '-qm',
+ 'inherited debt'
+ ])
+ const inheritedBase = run('git', ['rev-parse', 'HEAD']).trim()
+ await write('lib.ts', 'export const live = 3\nexport const unused = 1\n')
+ const inherited = run('comfy-code-quality', [
+ 'audit',
+ '--base',
+ inheritedBase,
+ '--json'
+ ])
+ assert.equal(JSON.parse(inherited).verdict, 'pass')
+ process.stdout.write(
+ `${manager}: packed CLI, ESLint-only/hybrid lint, Vue/async/test rules, both formatter profiles, and Fallow gates passed\n`
+ )
+} finally {
+ await rm(directory, { recursive: true, force: true })
+}
diff --git a/packages/code-quality/src/cli.ts b/packages/code-quality/src/cli.ts
new file mode 100644
index 00000000000..848105b9fc9
--- /dev/null
+++ b/packages/code-quality/src/cli.ts
@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { main } from './run.js'
+
+try {
+ process.exitCode = await main(process.argv.slice(2))
+} catch (error) {
+ console.error(error instanceof Error ? error.message : String(error))
+ process.exitCode = 2
+}
diff --git a/packages/code-quality/src/config.ts b/packages/code-quality/src/config.ts
new file mode 100644
index 00000000000..9dc7fc82b3e
--- /dev/null
+++ b/packages/code-quality/src/config.ts
@@ -0,0 +1,39 @@
+import { readFile } from 'node:fs/promises'
+
+export interface QualityConfig {
+ lint: { eslint: string[]; oxlint?: string[] }
+ format: { engine: 'oxfmt' | 'prettier'; args?: string[] }
+ audit?: string[]
+}
+
+function strings(value: unknown): value is string[] {
+ return Array.isArray(value) && value.every((item) => typeof item === 'string')
+}
+
+function object(value: unknown): value is Record {
+ return typeof value === 'object' && value !== null
+}
+
+export async function readConfig(file: string): Promise {
+ const value: unknown = JSON.parse(await readFile(file, 'utf8'))
+ if (
+ !object(value) ||
+ !object(value.lint) ||
+ !strings(value.lint.eslint) ||
+ value.lint.eslint.length === 0 ||
+ (value.lint.oxlint !== undefined && !strings(value.lint.oxlint)) ||
+ !object(value.format) ||
+ (value.format.engine !== 'oxfmt' && value.format.engine !== 'prettier') ||
+ (value.format.args !== undefined && !strings(value.format.args)) ||
+ (value.audit !== undefined && !strings(value.audit))
+ ) {
+ throw new Error(
+ `Invalid ${file}: expected lint.eslint arguments and format.engine (oxfmt or prettier)`
+ )
+ }
+ return {
+ lint: { eslint: value.lint.eslint, oxlint: value.lint.oxlint },
+ format: { engine: value.format.engine, args: value.format.args },
+ audit: value.audit
+ }
+}
diff --git a/packages/code-quality/src/eslint.ts b/packages/code-quality/src/eslint.ts
new file mode 100644
index 00000000000..632faa8e48d
--- /dev/null
+++ b/packages/code-quality/src/eslint.ts
@@ -0,0 +1,56 @@
+import type { Linter } from 'eslint'
+
+export { default as typescript } from 'typescript-eslint'
+export { default as vue } from 'eslint-plugin-vue'
+export { default as vueParser } from 'vue-eslint-parser'
+export { importX } from 'eslint-plugin-import-x'
+export { default as oxlint } from 'eslint-plugin-oxlint'
+export { default as playwright } from 'eslint-plugin-playwright'
+export { default as prettier } from 'eslint-config-prettier/flat'
+
+export function imports(
+ namespace: 'import' | 'import-x' = 'import-x'
+): Linter.Config {
+ return {
+ name: '@comfyorg/code-quality/imports',
+ rules: {
+ '@typescript-eslint/consistent-type-imports': 'error',
+ [`${namespace}/consistent-type-specifier-style`]: [
+ 'error',
+ 'prefer-top-level'
+ ]
+ }
+ }
+}
+
+export const vueTemplates: Linter.Config = {
+ name: '@comfyorg/code-quality/vue-templates',
+ rules: { 'vue/no-use-v-else-with-v-for': 'error' }
+}
+
+export const asyncSafety: Linter.Config = {
+ name: '@comfyorg/code-quality/async-safety',
+ rules: { '@typescript-eslint/no-floating-promises': 'error' }
+}
+
+export const browserTests: Linter.Config = {
+ name: '@comfyorg/code-quality/browser-tests',
+ rules: {
+ 'playwright/no-focused-test': 'error',
+ 'playwright/no-wait-for-timeout': 'error',
+ 'playwright/no-force-option': 'error',
+ 'playwright/prefer-web-first-assertions': 'error',
+ 'playwright/valid-expect': 'error',
+ 'playwright/missing-playwright-await': 'error'
+ }
+}
+
+export { default as vitest } from '@vitest/eslint-plugin'
+
+export const unitTests: Linter.Config = {
+ name: '@comfyorg/code-quality/unit-tests',
+ rules: {
+ 'vitest/no-focused-tests': 'error',
+ 'vitest/valid-expect': ['error', { maxArgs: 2 }]
+ }
+}
diff --git a/packages/code-quality/src/format.ts b/packages/code-quality/src/format.ts
new file mode 100644
index 00000000000..9a317118999
--- /dev/null
+++ b/packages/code-quality/src/format.ts
@@ -0,0 +1,15 @@
+export const frontend = {
+ singleQuote: true,
+ tabWidth: 2,
+ semi: false,
+ trailingComma: 'none',
+ printWidth: 80
+} as const
+
+export const platform = {
+ singleQuote: false,
+ tabWidth: 2,
+ semi: true,
+ trailingComma: 'all',
+ printWidth: 80
+} as const
diff --git a/packages/code-quality/src/plugin.ts b/packages/code-quality/src/plugin.ts
new file mode 100644
index 00000000000..24c0933c4e6
--- /dev/null
+++ b/packages/code-quality/src/plugin.ts
@@ -0,0 +1,27 @@
+import type { ESLint, Rule } from 'eslint'
+
+const noJsPrivateClassMembers: Rule.RuleModule = {
+ meta: { schema: [], type: 'problem' },
+ create(context) {
+ return {
+ PrivateIdentifier(node) {
+ const parent = context.sourceCode.getAncestors(node).at(-1)
+ if (
+ parent?.type === 'PropertyDefinition' ||
+ parent?.type === 'MethodDefinition'
+ ) {
+ context.report({
+ node,
+ message:
+ 'Do not use JavaScript hard-private class members. Use TypeScript private members instead.'
+ })
+ }
+ }
+ }
+ }
+}
+
+export default {
+ meta: { name: '@comfyorg/code-quality' },
+ rules: { 'no-js-private-class-members': noJsPrivateClassMembers }
+} satisfies ESLint.Plugin
diff --git a/packages/code-quality/src/run.ts b/packages/code-quality/src/run.ts
new file mode 100644
index 00000000000..9b5b5be6164
--- /dev/null
+++ b/packages/code-quality/src/run.ts
@@ -0,0 +1,175 @@
+import { spawnSync } from 'node:child_process'
+import { mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { createRequire } from 'node:module'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { parseArgs } from 'node:util'
+
+import { readConfig } from './config.js'
+import type { QualityConfig } from './config.js'
+
+const require = createRequire(import.meta.url)
+const binaries = {
+ eslint: 'bin/eslint.js',
+ oxlint: 'bin/oxlint',
+ oxfmt: 'bin/oxfmt',
+ prettier: 'bin/prettier.cjs',
+ fallow: 'bin/fallow'
+} as const
+
+function run(tool: keyof typeof binaries, args: string[]): number {
+ const root = dirname(require.resolve(`${tool}/package.json`))
+ const result = spawnSync(
+ process.execPath,
+ [join(root, binaries[tool]), ...args],
+ {
+ stdio: 'inherit'
+ }
+ )
+ if (result.error) throw result.error
+ return result.status ?? 1
+}
+
+function git(args: string[]): string {
+ const result = spawnSync('git', args, {
+ encoding: 'utf8',
+ maxBuffer: 64 * 1024 * 1024
+ })
+ if (result.error) throw result.error
+ if (result.status !== 0) throw new Error(result.stderr.trim() || 'git failed')
+ return result.stdout
+}
+
+export async function main(args: string[]): Promise {
+ const [command = 'help', ...rest] = args
+ switch (command) {
+ case 'help':
+ case '--help':
+ case '-h':
+ process.stdout
+ .write(`Usage: comfy-code-quality [options] [paths...]
+ lint [--fix] Run configured Oxlint, then ESLint
+ format [--check] Format with the configured engine
+ audit --base [--json] Audit added lines against a Git commit
+ exec [args...] Run a pinned engine with its native arguments
+ -c, --config Config path (default: code-quality.config.json)
+ -h, --help Show help
+ -V, --version Show package version
+Paths are appended to configured lint/format arguments. Keep scopes in config.
+Audit writes no baselines. Native tool output and failure status are preserved.\n`)
+ return 0
+ case '--version':
+ case '-V':
+ process.stdout.write(`${require('../package.json').version}\n`)
+ return 0
+ case 'exec':
+ return native(rest)
+ case 'lint':
+ case 'format':
+ case 'audit':
+ return configured(command, rest)
+ default:
+ throw new Error(`Unknown command: ${command}`)
+ }
+}
+
+function native(args: string[]): number {
+ const [tool = '(missing)', ...rest] = args
+ if (!isTool(tool)) throw new Error(`Unknown tool: ${tool}`)
+ return run(tool, rest)
+}
+
+async function configured(command: string, rest: string[]): Promise {
+ const { values, positionals } = parseOptions(command, rest)
+ if (values.help) return main(['help'])
+ const config = await readConfig(values.config)
+ if (command === 'lint') {
+ const extra = [...(values.fix ? ['--fix'] : []), ...positionals]
+ return lint(config.lint, extra)
+ }
+ if (command === 'format') {
+ return format(config.format, values.check === true, positionals)
+ }
+ if (typeof values.base !== 'string' || positionals.length)
+ throw new Error('audit requires --base and accepts no paths')
+ return audit(config.audit ?? [], values.base, values.json === true)
+}
+
+function parseOptions(command: string, args: string[]) {
+ return parseArgs({
+ args,
+ allowPositionals: true,
+ options: {
+ config: {
+ type: 'string',
+ short: 'c',
+ default: 'code-quality.config.json'
+ },
+ help: { type: 'boolean', short: 'h' },
+ ...(command === 'lint' ? { fix: { type: 'boolean' as const } } : {}),
+ ...(command === 'format' ? { check: { type: 'boolean' as const } } : {}),
+ ...(command === 'audit'
+ ? {
+ base: { type: 'string' as const, short: 'b' },
+ json: { type: 'boolean' as const }
+ }
+ : {})
+ }
+ })
+}
+
+async function audit(
+ args: string[],
+ baseRef: string,
+ json: boolean
+): Promise {
+ const base = git([
+ 'rev-parse',
+ '--verify',
+ '--end-of-options',
+ `${baseRef}^{commit}`
+ ]).trim()
+ const directory = await mkdtemp(join(tmpdir(), 'comfy-code-quality-'))
+ try {
+ const diffFile = join(directory, 'changes.diff')
+ await writeFile(
+ diffFile,
+ git(['diff', '--no-ext-diff', '--unified=0', '--relative', base, '--'])
+ )
+ return run('fallow', [
+ 'audit',
+ ...args,
+ '--changed-since',
+ base,
+ '--diff-file',
+ diffFile,
+ ...(json ? ['--format', 'json'] : [])
+ ])
+ } finally {
+ await rm(directory, { recursive: true, force: true })
+ }
+}
+
+function lint(config: QualityConfig['lint'], extra: string[]): number {
+ if (config.oxlint) {
+ const status = run('oxlint', [...config.oxlint, ...extra])
+ if (status !== 0) return status
+ }
+ return run('eslint', [...config.eslint, ...extra])
+}
+
+function isTool(value: string): value is keyof typeof binaries {
+ return Object.hasOwn(binaries, value)
+}
+
+function format(
+ config: QualityConfig['format'],
+ check: boolean,
+ paths: string[]
+): number {
+ return run(config.engine, [
+ ...(config.args ?? []),
+ check ? '--check' : '--write',
+ ...paths
+ ])
+}
diff --git a/packages/code-quality/tests/cli.test.ts b/packages/code-quality/tests/cli.test.ts
new file mode 100644
index 00000000000..31930b65643
--- /dev/null
+++ b/packages/code-quality/tests/cli.test.ts
@@ -0,0 +1,40 @@
+import { spawnSync } from 'node:child_process'
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { expect, it } from 'vitest'
+
+const binary = resolve(import.meta.dirname, '../dist/cli.js')
+
+it('runs the built formatter command and propagates failures', async () => {
+ const cwd = await mkdtemp(join(tmpdir(), 'quality-cli-'))
+ function run(args: string[]) {
+ return spawnSync(process.execPath, [binary, ...args], {
+ cwd,
+ encoding: 'utf8'
+ })
+ }
+ try {
+ await writeFile(
+ join(cwd, 'code-quality.config.json'),
+ JSON.stringify({
+ lint: { eslint: ['.'] },
+ format: { engine: 'prettier', args: ['input.ts'] }
+ })
+ )
+ await writeFile(join(cwd, 'input.ts'), 'export const name="hello"')
+ expect(run(['format', '--check']).status).toBe(1)
+ expect(run(['format']).status).toBe(0)
+ expect(await readFile(join(cwd, 'input.ts'), 'utf8')).toBe(
+ 'export const name = "hello";\n'
+ )
+ expect(run(['format', '--check']).status).toBe(0)
+ const unknown = run(['no-such-command'])
+ expect(unknown.status).toBe(2)
+ expect(unknown.stdout).toBe('')
+ expect(unknown.stderr).toContain('Unknown command')
+ expect(run(['--help']).status).toBe(0)
+ } finally {
+ await rm(cwd, { recursive: true, force: true })
+ }
+})
diff --git a/packages/code-quality/tests/config.test.ts b/packages/code-quality/tests/config.test.ts
new file mode 100644
index 00000000000..00edd728b41
--- /dev/null
+++ b/packages/code-quality/tests/config.test.ts
@@ -0,0 +1,63 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterEach, expect, it, vi } from 'vitest'
+
+import { readConfig } from '../src/config.js'
+import { main } from '../src/run.js'
+
+const directories: string[] = []
+afterEach(async () => {
+ await Promise.all(
+ directories
+ .splice(0)
+ .map((directory) => rm(directory, { recursive: true, force: true }))
+ )
+})
+
+async function config(value: unknown): Promise {
+ const directory = await mkdtemp(join(tmpdir(), 'quality-config-'))
+ directories.push(directory)
+ const file = join(directory, 'config.json')
+ await writeFile(file, JSON.stringify(value))
+ return file
+}
+
+it('accepts explicit ESLint-only and hybrid consumer scopes', async () => {
+ for (const lint of [
+ { eslint: ['src'] },
+ { eslint: ['src'], oxlint: ['src', '--type-aware'] }
+ ]) {
+ const value = {
+ lint,
+ format: { engine: 'prettier', args: ['.'] },
+ audit: ['--quiet']
+ }
+ expect(await readConfig(await config(value))).toEqual(value)
+ }
+})
+
+it.for([
+ null,
+ {},
+ { lint: { eslint: [] }, format: { engine: 'oxfmt' } },
+ { lint: { eslint: ['src'], oxlint: 'src' }, format: { engine: 'oxfmt' } },
+ { lint: { eslint: ['src'] }, format: { engine: 'other' } }
+])('rejects malformed configuration %j', async (value) => {
+ await expect(readConfig(await config(value))).rejects.toThrow('Invalid')
+})
+
+it.for(['--help', '-h', 'help'])(
+ 'shows help without requiring configuration: %s',
+ async (argument) => {
+ const output = vi.spyOn(process.stdout, 'write').mockReturnValue(true)
+ expect(await main([argument])).toBe(0)
+ expect(output).toHaveBeenCalledWith(expect.stringContaining('--base'))
+ }
+)
+
+it('rejects unknown commands and options before running a tool', async () => {
+ await expect(main(['deploy'])).rejects.toThrow('Unknown command')
+ await expect(main(['lint', '--unknown'])).rejects.toThrow('Unknown option')
+ await expect(main(['format', '--fix'])).rejects.toThrow('Unknown option')
+})
diff --git a/packages/code-quality/tests/policy.test.ts b/packages/code-quality/tests/policy.test.ts
new file mode 100644
index 00000000000..63a7c813065
--- /dev/null
+++ b/packages/code-quality/tests/policy.test.ts
@@ -0,0 +1,89 @@
+import { ESLint } from 'eslint'
+import { expect, it } from 'vitest'
+
+import {
+ imports,
+ importX,
+ typescript,
+ vue,
+ vueParser,
+ vueTemplates
+} from '../src/eslint.js'
+import plugin from '../src/plugin.js'
+
+it('rejects mixed type imports while accepting separate type imports', async () => {
+ const eslint = new ESLint({
+ overrideConfigFile: true,
+ overrideConfig: [
+ {
+ files: ['**/*.ts'],
+ languageOptions: { parser: typescript.parser },
+ plugins: {
+ '@typescript-eslint': typescript.plugin,
+ 'import-x': importX
+ },
+ ...imports()
+ }
+ ]
+ })
+ const bad = await eslint.lintText(
+ "import { type Input, live } from './lib'\nexport const name = (input: Input) => live(input)\n",
+ { filePath: 'probe.ts' }
+ )
+ expect(bad[0].messages.map((message) => message.ruleId)).toContain(
+ 'import-x/consistent-type-specifier-style'
+ )
+ const good = await eslint.lintText(
+ "import type { Input } from './lib'\nimport { live } from './lib'\nexport const name = (input: Input) => live(input)\n",
+ { filePath: 'probe.ts' }
+ )
+ expect(good[0].errorCount).toBe(0)
+})
+
+it('keeps Vue template checks available independently of Oxlint', async () => {
+ const eslint = new ESLint({
+ overrideConfigFile: true,
+ overrideConfig: [
+ {
+ files: ['**/*.vue'],
+ languageOptions: {
+ parser: vueParser,
+ parserOptions: { parser: typescript.parser }
+ },
+ plugins: { vue },
+ ...vueTemplates
+ }
+ ]
+ })
+ const [result] = await eslint.lintText(
+ 'Ready
{{ item }}
',
+ { filePath: 'Probe.vue' }
+ )
+ expect(result.messages.map((message) => message.ruleId)).toContain(
+ 'vue/no-use-v-else-with-v-for'
+ )
+})
+
+it('distinguishes JavaScript private members from TypeScript private members', async () => {
+ const eslint = new ESLint({
+ overrideConfigFile: true,
+ overrideConfig: [
+ {
+ files: ['**/*.ts'],
+ languageOptions: { parser: typescript.parser },
+ plugins: { comfy: plugin },
+ rules: { 'comfy/no-js-private-class-members': 'error' }
+ }
+ ]
+ })
+ for (const [member, count] of [
+ ['#value', 1],
+ ['private value', 0]
+ ] as const) {
+ const [result] = await eslint.lintText(
+ `export class Model { ${member} = 1 }`,
+ { filePath: 'probe.ts' }
+ )
+ expect(result.errorCount).toBe(count)
+ }
+})
diff --git a/packages/code-quality/tsconfig.build.json b/packages/code-quality/tsconfig.build.json
new file mode 100644
index 00000000000..65178f44c01
--- /dev/null
+++ b/packages/code-quality/tsconfig.build.json
@@ -0,0 +1,10 @@
+{
+ "extends": "./tsconfig.json",
+ "compilerOptions": {
+ "noEmit": false,
+ "declaration": true,
+ "rootDir": "src",
+ "outDir": "dist"
+ },
+ "include": ["src/**/*.ts"]
+}
diff --git a/packages/code-quality/tsconfig.json b/packages/code-quality/tsconfig.json
new file mode 100644
index 00000000000..4198169d067
--- /dev/null
+++ b/packages/code-quality/tsconfig.json
@@ -0,0 +1,13 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "NodeNext",
+ "moduleResolution": "NodeNext",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "noEmit": true,
+ "types": ["node"]
+ },
+ "include": ["src/**/*.ts", "tests/**/*.ts", "scripts/**/*.ts"]
+}
diff --git a/packages/code-quality/vitest.config.ts b/packages/code-quality/vitest.config.ts
new file mode 100644
index 00000000000..af9108136d1
--- /dev/null
+++ b/packages/code-quality/vitest.config.ts
@@ -0,0 +1,14 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+ test: {
+ environment: 'node',
+ restoreMocks: true,
+ include: ['tests/**/*.test.ts'],
+ coverage: {
+ provider: 'v8',
+ include: ['src/**/*.ts'],
+ reporter: ['text', 'html', 'lcov']
+ }
+ }
+})
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 08ae062eb53..3b3e38c0e24 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -473,6 +473,7 @@ catalogs:
version: 3.5.4
overrides:
+ '@comfyorg/code-quality>prettier': 3.5.3
vite: ^8.2.2
'@tiptap/pm': 3.31.0
prettier: 3.9.5
@@ -1355,6 +1356,67 @@ importers:
specifier: 'catalog:'
version: 5.0.2(@types/node@25.9.5)(@vitest/coverage-v8@5.0.2)(@vitest/ui@5.0.2)(happy-dom@20.14.5)(jsdom@29.1.1)(vite@8.2.2(@types/node@25.9.5)(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(tsx@4.23.1)(yaml@2.9.0))
+ packages/code-quality:
+ dependencies:
+ '@vitest/eslint-plugin':
+ specifier: 1.6.27
+ version: 1.6.27(@typescript-eslint/eslint-plugin@8.69.0(@typescript-eslint/parser@8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3)(vitest@5.0.2)
+ eslint:
+ specifier: 10.10.0
+ version: 10.10.0(jiti@2.7.0)
+ eslint-config-prettier:
+ specifier: 10.1.8
+ version: 10.1.8(eslint@10.10.0(jiti@2.7.0))
+ eslint-plugin-import-x:
+ specifier: 4.17.1
+ version: 4.17.1(@typescript-eslint/utils@8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))
+ eslint-plugin-oxlint:
+ specifier: 1.77.0
+ version: 1.77.0(oxlint@1.77.0(oxlint-tsgolint@7.0.2001))
+ eslint-plugin-playwright:
+ specifier: 2.11.0
+ version: 2.11.0(eslint@10.10.0(jiti@2.7.0))
+ eslint-plugin-vue:
+ specifier: 10.10.0
+ version: 10.10.0(@typescript-eslint/parser@8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(vue-eslint-parser@10.4.1(eslint@10.10.0(jiti@2.7.0)))
+ fallow:
+ specifier: 3.24.1
+ version: 3.24.1
+ oxfmt:
+ specifier: 0.59.0
+ version: 0.59.0
+ oxlint:
+ specifier: 1.77.0
+ version: 1.77.0(oxlint-tsgolint@7.0.2001)
+ oxlint-tsgolint:
+ specifier: 7.0.2001
+ version: 7.0.2001
+ prettier:
+ specifier: 3.5.3
+ version: 3.5.3
+ typescript:
+ specifier: 6.0.3
+ version: 6.0.3
+ typescript-eslint:
+ specifier: 8.69.0
+ version: 8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3)
+ vue-eslint-parser:
+ specifier: 10.4.1
+ version: 10.4.1(eslint@10.10.0(jiti@2.7.0))
+ devDependencies:
+ '@types/node':
+ specifier: 'catalog:'
+ version: 25.9.5
+ '@vitest/coverage-v8':
+ specifier: 'catalog:'
+ version: 5.0.2(vitest@5.0.2)
+ tsx:
+ specifier: 'catalog:'
+ version: 4.23.1
+ vitest:
+ specifier: 'catalog:'
+ version: 5.0.2(@types/node@25.9.5)(@vitest/coverage-v8@5.0.2)(@vitest/ui@5.0.2)(happy-dom@20.14.5)(jsdom@29.1.1)(vite@8.2.2(@types/node@25.9.5)(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(tsx@4.23.1)(yaml@2.9.0))
+
packages/design-system:
dependencies:
'@iconify-json/lucide':
@@ -5128,6 +5190,22 @@ packages:
'@vitest/browser':
optional: true
+ '@vitest/eslint-plugin@1.6.27':
+ resolution: {integrity: sha512-X1RCAfwbatG4GFbJ/1PIHP9MSZMt0JJThqbYID+vS4L783k6QGlLPe421wQE8dHXuGCcenVLsydiM4qzsYWxhg==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ '@typescript-eslint/eslint-plugin': '*'
+ eslint: '>=8.57.0'
+ typescript: '>=5.0.0'
+ vitest: '*'
+ peerDependenciesMeta:
+ '@typescript-eslint/eslint-plugin':
+ optional: true
+ typescript:
+ optional: true
+ vitest:
+ optional: true
+
'@vitest/expect@3.2.4':
resolution: {integrity: sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig==}
@@ -6301,6 +6379,11 @@ packages:
eslint-import-resolver-node:
optional: true
+ eslint-plugin-oxlint@1.77.0:
+ resolution: {integrity: sha512-+hAAOHn0KeIdq9yb+tSHnqS9oYtx+gZLJKAiNlAmFz7ydlrC2orbwZCcHWC4qU98t6Ju8FKfWTer/VbAnpK5ZA==}
+ peerDependencies:
+ oxlint: ~1.77.0
+
eslint-plugin-oxlint@1.81.0:
resolution: {integrity: sha512-yoig+eqijGmt+09wBOi71H8teCXFuDnOePWOiU1ynrME1WiOkw7zEFtkQwbacPYGjrbqhd5XXU4lQDzRWojW0g==}
peerDependencies:
@@ -8213,6 +8296,11 @@ packages:
peerDependencies:
prettier: 3.9.5
+ prettier@3.5.3:
+ resolution: {integrity: sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==}
+ engines: {node: '>=14'}
+ hasBin: true
+
prettier@3.9.5:
resolution: {integrity: sha512-/FVl766LpUfB5vXgCYOYa0MeV/441Ia99AeICQIQFTY/Nw0roZwULcXpku5i1/m5kt/baz+s4Zogspd839HSMg==}
engines: {node: '>=14'}
@@ -13435,6 +13523,18 @@ snapshots:
tinyrainbow: 3.1.1
vitest: 5.0.2(@types/node@25.9.5)(@vitest/coverage-v8@5.0.2)(@vitest/ui@5.0.2)(happy-dom@20.14.5)(jsdom@29.1.1)(vite@8.2.2(@types/node@25.9.5)(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(tsx@4.23.1)(yaml@2.9.0))
+ '@vitest/eslint-plugin@1.6.27(@typescript-eslint/eslint-plugin@8.69.0(@typescript-eslint/parser@8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3)(vitest@5.0.2)':
+ dependencies:
+ '@typescript-eslint/scope-manager': 8.69.0
+ '@typescript-eslint/utils': 8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3)
+ eslint: 10.10.0(jiti@2.7.0)
+ optionalDependencies:
+ '@typescript-eslint/eslint-plugin': 8.69.0(@typescript-eslint/parser@8.69.0(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3))(eslint@10.10.0(jiti@2.7.0))(typescript@6.0.3)
+ typescript: 6.0.3
+ vitest: 5.0.2(@types/node@25.9.5)(@vitest/coverage-v8@5.0.2)(@vitest/ui@5.0.2)(happy-dom@20.14.5)(jsdom@29.1.1)(vite@8.2.2(@types/node@25.9.5)(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(tsx@4.23.1)(yaml@2.9.0))
+ transitivePeerDependencies:
+ - supports-color
+
'@vitest/expect@3.2.4':
dependencies:
'@types/chai': 5.2.3
@@ -14817,6 +14917,11 @@ snapshots:
transitivePeerDependencies:
- supports-color
+ eslint-plugin-oxlint@1.77.0(oxlint@1.77.0(oxlint-tsgolint@7.0.2001)):
+ dependencies:
+ jsonc-parser: 3.3.1
+ oxlint: 1.77.0(oxlint-tsgolint@7.0.2001)
+
eslint-plugin-oxlint@1.81.0(oxlint@1.77.0(oxlint-tsgolint@7.0.2001)):
dependencies:
jsonc-parser: 3.3.1
@@ -17213,6 +17318,8 @@ snapshots:
- '@emnapi/core'
- '@emnapi/runtime'
+ prettier@3.5.3: {}
+
prettier@3.9.5: {}
pretty-bytes@7.1.1: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 9e2a4317f1b..2235c685353 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -186,6 +186,7 @@ allowBuilds:
vue-demi: false
overrides:
+ '@comfyorg/code-quality>prettier': 3.5.3
vite: 'catalog:'
'@tiptap/pm': 3.31.0
prettier: 3.9.5