{"_id":"@efolusi/meridian-guard","_rev":"8-fb64e8ebce5f35f57b7c78f75065fab5","name":"@efolusi/meridian-guard","dist-tags":{"latest":"1.21.9"},"versions":{"1.21.2":{"name":"@efolusi/meridian-guard","version":"1.21.2","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.2","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"5a7a3956791c01dae5f520c08957b92068a74740","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.2.tgz","fileCount":10,"integrity":"sha512-J9D8vLKKuHnj6STUSPoUwjxqasIg15hhTkhm7yAYf/a0wiYTJk4F0NB2Thz9ZpCZkyCUyZYtKEJ8Y0QJHfOZFA==","signatures":[{"sig":"MEYCIQCvzslw8IdF2d1CrO6xZDgyhkQMDvvUvD5DoJ4NciwG5wIhAJugYLdD2KBJdEWy8sYYSyOLlGUiAmuKa2oO81efvdYS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63138},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"a9b0e24a156927c16b3e02cd6650be4f62346fd6","_npmUser":{"name":"efolusi","email":"admin@efolusi.com"},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"11.16.0","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.2_1786655088118_0.24680059572231294","host":"s3://npm-registry-packages-npm-production"}},"1.21.3":{"name":"@efolusi/meridian-guard","version":"1.21.3","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.3","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"7017bc9cfbd053cab179b76b29e30080e4ecac1c","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.3.tgz","fileCount":10,"integrity":"sha512-VqZqNTZmhEfDArVS3SHWYu99UzP7LVLG/3pPlmeGOL3/jqgI2/2Wod1Cz/ui23tTOipl8DIEKJ0T6rGk2+fEWw==","signatures":[{"sig":"MEUCIEgUsSfzmhUueY84fao4aeGzUqELZRUWf/EFgjW4MX+3AiEArLBaTMcGa8lzJ5jzxeIqqPib14f7SWfRlpmcNVPCTYs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65856},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"f3ccfed7d3b2bf6dc7967813b94334f4bc9665ba","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.3_1786656057079_0.8664714977451826","host":"s3://npm-registry-packages-npm-production"}},"1.21.4":{"name":"@efolusi/meridian-guard","version":"1.21.4","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.4","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"c6fde31f60a3060dbc546986f751dc6a0a53f2c6","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.4.tgz","fileCount":10,"integrity":"sha512-I4vWTWN7sxDX4aWFx/Zu4JeOHLKoYzhLDSySi40rZm1/f/WkXBPblg+F4dMME9N3QHsQZ3vwnIaCPfITsG63ng==","signatures":[{"sig":"MEQCIEWBr3Wod3wcUJ9a04nn+BciddNTLULi93TdNGt23jk5AiBQ1fKN9eg2pmHqX6f++LTlttgN4H/3QiMO8QzFH1kqww==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":65856},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"0a63181b3247503cb71a88c4f9d505f565d5bc18","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.4_1788560952696_0.6512290097536066","host":"s3://npm-registry-packages-npm-production"}},"1.21.5":{"name":"@efolusi/meridian-guard","version":"1.21.5","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.5","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"6783ee3263467713148a4eb26525d9ce557399dc","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.5.tgz","fileCount":10,"integrity":"sha512-GbbY8CZI96HwXmgD6rBR8tG0imH4dJTAGFlGhIGsCXsOppFe1ZZpVXR+J5hvtiCI/RhqHgED5cH9HOFJEKb7Lg==","signatures":[{"sig":"MEUCIQCCsiDaZ/EpKOrMJOJ03Q3p+QTR4NKxz51sToIEnnJM/QIgXphmntcnAsk6NVya3b/rKwXvqBsTdQadByUCG5vZDZQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":72637},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"af954c129ca891cee572e9b87f57d453e8e6547e","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.5_1788575171440_0.5641266656852397","host":"s3://npm-registry-packages-npm-production"}},"1.21.6":{"name":"@efolusi/meridian-guard","version":"1.21.6","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.6","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"cbab5f1dae709a12a3455862eb1ae39f157bd891","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.6.tgz","fileCount":10,"integrity":"sha512-x7ZAqAgT2LEhONtcL1TGmPErpRHOhzqth5HzZD0jGxtPtTCYjGbR5w/yb6JOAXzEl4uhH1XqAerPSuL9ocS4ww==","signatures":[{"sig":"MEUCIQDqHq1AUBYzjdda2m9MReC9Aki0t+NLBCLxozXLug60jwIgO8mM5lpC/V0rbdrIt+ZMbTvxHLis6vJCwSk8mhA8/7A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":72637},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"66ddfb4e48b723f3ad5eadc783b189af89857e71","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.6_1788592667565_0.40739075738341013","host":"s3://npm-registry-packages-npm-production"}},"1.21.7":{"name":"@efolusi/meridian-guard","version":"1.21.7","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.7","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"0da2a61da9bf4241bc4f1647c15836570431b55f","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.7.tgz","fileCount":10,"integrity":"sha512-Q2P2sDaaw8ec6IqI1yJpfNKdXNTLXvuQQJXytKb1uqe3FIQBUVM/P2oHFFb1Mx1DnElxZpR3DVwrcWKuE4tUEQ==","signatures":[{"sig":"MEYCIQCnjq2w+AijyfiNMOI0TGiU1mZr+ZMUBSZBTLt1iBWnuwIhAM8dtOA/8B83NEREH2zU6vnWC+q80yR283ENhdmTWv/R","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIG2S05873HqX8Fc/W+9E4o9xqvVI1T0el6QfW14CrrP5AiA/hRPlYdgu0ijtXvZK8+YkxFln7Va+QMqhV2ABw/t3yg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":72669},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"c79eef86149e1a9e8ab22e356e3942d656780733","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.7_1789761284132_0.4309457295247683","host":"s3://npm-registry-packages-npm-production"}},"1.21.8":{"name":"@efolusi/meridian-guard","version":"1.21.8","keywords":["design-system","accessibility","lint","meridian","react"],"license":"MIT","_id":"@efolusi/meridian-guard@1.21.8","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"homepage":"https://meridian.efolusi.com","bugs":{"url":"https://github.com/efolusi/meridian/issues"},"bin":{"meridian-guard":"bin/meridian-guard.js"},"dist":{"shasum":"2234915567a975e92376662392d954752bb85422","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.8.tgz","fileCount":10,"integrity":"sha512-NlJTyg9+uibHkZLUEF8jrcHBe+FleFeewtanQVzGERxNqRldVV/Q/tsbDhtJ7uwL3EqeNDMkmGCWdWn1e3/Bdw==","signatures":[{"sig":"MEUCICNRedQxbwpjuKeu400CgOs4BGINZNAQ6Fa/I+N6GobUAiEApmY3Q/8OR0JCtOiCVlNuYQApw5TyJsUWpv9NcQ+TgVY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDhsScUEq3tN0zJ2OIzhemLUJThVtizGPn61I7PF084cQIhAKwgcdzuCfZnVJ4SXLpLrlClIMI6bexgna1kYLG4e/7o","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.8","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":72669},"main":"./src/index.mjs","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"fd2fae94bc2658a4f0531ce2c6880db4211d9dc9","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/meridian-guard_1.21.8_1789768366110_0.07673669266821759","host":"s3://npm-registry-packages-npm-production"}},"1.21.9":{"_id":"@efolusi/meridian-guard@1.21.9","bin":{"meridian-guard":"bin/meridian-guard.js"},"bugs":{"url":"https://github.com/efolusi/meridian/issues"},"dist":{"shasum":"7b188a0faffb5acdeb1a15954c73d2d13c44054c","tarball":"https://registry.npmjs.org/@efolusi/meridian-guard/-/meridian-guard-1.21.9.tgz","fileCount":10,"integrity":"sha512-JVpDyMjhLyZBSEaXzNFpU8LJttjAXl2IqWeqgdw/UWp+rc1rspFmLPNnKI7b7EdXWmItS00odBgMRTOuzphhkA==","signatures":[{"sig":"MEYCIQDGoSkvFrsxXCUzCdrGZJQskvt9s8h1AvdaA0LcvCXl3wIhAKmYuifkFOCR1icCytcg9dnawm6zJ/4YHNskhij5I6E2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHXTScj2+WQ/w3l0AatoAgWggHDPcFCcyIDanyaNqkoGAiAfs64Qrlkxao+OiD06CGBXMF49jV0J7I08whBmZVQ7Zg=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@efolusi%2fmeridian-guard@1.21.9","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":72765},"main":"./src/index.mjs","name":"@efolusi/meridian-guard","type":"module","engines":{"node":">=20.10"},"exports":{".":"./src/index.mjs","./package.json":"./package.json"},"gitHead":"355ffb491b89285a720d8486ce001049ba49d758","license":"MIT","version":"1.21.9","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5176ca1c-0e63-4b97-b209-851cea271ccd"}},"homepage":"https://meridian.efolusi.com","keywords":["design-system","accessibility","lint","meridian","react"],"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"_npmVersion":"12.0.2","description":"Static compliance checks for React applications built with the Meridian design system.","directories":{},"maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"_nodeVersion":"22.23.2","dependencies":{"@babel/parser":"^7.28.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/meridian-guard_1.21.9_1789790652405_0.9757477205036444"}}},"time":{"created":"2026-08-13T21:04:47.972Z","modified":"2026-09-19T04:04:12.817Z","1.21.2":"2026-08-13T21:04:48.289Z","1.21.3":"2026-08-13T21:20:57.245Z","1.21.4":"2026-09-04T22:29:12.826Z","1.21.5":"2026-09-05T02:26:11.595Z","1.21.6":"2026-09-05T07:17:47.756Z","1.21.7":"2026-09-18T19:54:44.228Z","1.21.8":"2026-09-18T21:52:46.192Z","1.21.9":"2026-09-19T04:04:12.504Z"},"bugs":{"url":"https://github.com/efolusi/meridian/issues"},"license":"MIT","homepage":"https://meridian.efolusi.com","keywords":["design-system","accessibility","lint","meridian","react"],"repository":{"url":"git+https://github.com/efolusi/meridian.git","type":"git","directory":"packages/guard"},"description":"Static compliance checks for React applications built with the Meridian design system.","maintainers":[{"name":"efolusi","email":"admin@efolusi.com"}],"readme":"# Meridian Guard\n\nDeterministic compliance checks for React applications built with Meridian.\nGuard runs locally, never uploads source, and does not call an AI model.\n\n## Requirements and installation\n\nNode.js 20.10 or newer is required.\n\nInstall the public CLI as a development dependency:\n\n```sh\nnpm install --save-dev @efolusi/meridian-guard\n```\n\nAdd a repeatable project command:\n\n```json\n{\n  \"scripts\": {\n    \"guard\": \"meridian-guard src\"\n  }\n}\n```\n\nRun it with `npm run guard` locally and in CI.\n\n## Usage\n\n```sh\nnpx @efolusi/meridian-guard src\nnpx @efolusi/meridian-guard src pages --format json\nnpx meridian-guard --help\n```\n\nGuard exits `0` when no diagnostics are found, `1` when a contract violation is\nfound (including warnings), and `2` for invalid options, missing targets, empty\nscans, or runtime failures. An empty scan fails closed so a misspelled CI target\ncannot silently pass; use `--allow-empty` only when zero source files is expected.\n\nDirectories are scanned recursively;\ncommon dependency, framework-output, build, and coverage directories are\nignored (`node_modules`, `.next`, `.turbo`, `.open-next`, `.wrangler`, `dist`,\n`build`, `coverage`, and their equivalents). Symbolic links are not followed,\nkeeping a scan inside the requested source tree and safely skipping broken links.\nTest/spec fixtures and minified vendor scripts are also excluded because they are\nnot shipped interface source.\n\n## Rules\n\n| Rule | Severity | Contract |\n|---|---|---|\n| `MDG000` | error | Source must parse before it can be validated. |\n| `MDG001` | error | Imported Meridian components must exist. |\n| `MDG002` | error | Static `Icon` and `IconButton` names must exist. |\n| `MDG003` | warning | Inline and CSS-in-JS colors use semantic tokens, not hex. |\n| `MDG004` | warning | Deprecated props migrate to their canonical replacement. |\n| `MDG005` | error | Required accessible names and dialog titles are present. |\n| `MDG006` | error | Referenced Meridian radius tokens must exist in the generated token contract. |\n| `MDG007` | warning | Non-zero interface radii use the shared Meridian radius hierarchy. |\n| `MDG008` | warning | Box shadows use the warm Meridian elevation scale. |\n| `MDG009` | warning | Interface animation and transition durations do not exceed 240 ms. |\n| `MDG010` | warning | Font families use the Figtree, Bricolage, or JetBrains role tokens. |\n| `MDG011` | warning | Font sizes use Meridian's named type scale. |\n| `MDG012` | error | Consumer classes/styles do not repaint or reshape Button and IconButton chrome. |\n\nDynamic icon names cannot be proven statically and are left to the application.\nGuard currently validates Meridian imports from the umbrella package and its\ndocumented deep-import paths.\n\n## Continuous integration\n\nGitHub Actions needs no npm token for installing the public package:\n\n```yaml\n- uses: actions/setup-node@v5\n  with:\n    node-version: '22'\n- run: npm ci\n- run: npm run guard\n```\n\nUse `--format json` when another tool will consume the result. Its stable top-level\nfields are `version`, `filesScanned`, `errors`, `warnings`, and `diagnostics`.\nEvery diagnostic includes `file`, `line`, `column`, `ruleId`, `severity`, and\n`message`. The default pretty format is intended for terminal logs:\n\n```text\nsrc/Toolbar.jsx:8:5 error MDG002\n  \"magnify\" is not a Meridian icon. Choose a name from the icon registry.\n```\n\n## Programmatic API\n\nThe package also exports `guard`, `scanSource`, and the `RULES` metadata:\n\n```js\nimport { guard } from '@efolusi/meridian-guard';\n\nconst result = await guard(['src']);\nif (result.diagnostics.length) process.exitCode = 1;\n```\n\n`scanSource(source, filename, contracts)` is available for editor and test\nintegrations that already have source text. Most applications should use the CLI\nor `guard()` so they receive the packaged Meridian contract automatically.\n\n## Scope and troubleshooting\n\n- Guard parses JavaScript, JSX, TypeScript, TSX, MJS, CJS, and authored CSS. It is a focused\n  Meridian contract checker, not a replacement for ESLint or TypeScript.\n- Dynamic component and icon names cannot be proven statically and are skipped.\n- Test/spec files, fixtures, generated output, dependencies, minified files, and\n  symbolic links are intentionally skipped. Scan authored application directories.\n- There is no per-rule suppression or configuration file yet. If a diagnostic is\n  incorrect, report the smallest reproducible source at the Meridian repository\n  instead of hiding the rule globally.\n- Exit `2` usually means the target path is wrong, no supported files were found,\n  the source could not be read, or an option is invalid. The CLI prints the exact\n  cause to stderr.\n\n## Developing\n\nThe contract at `src/generated/meridian-rules.json` is generated from Meridian's\nmanifest, component declarations, tokens, and SVG directory. Regenerate it with:\n\n```sh\nnode scripts/build_guard_rules.mjs\n```\n\nDo not edit the generated file manually.\n","readmeFilename":"README.md"}